OSDN Git Service

Convert release and draft pages to UTF-8.
[linuxjm/jm.git] / manual / e2fsprogs / release / man3 / uuid_generate.3
index 336f9bc..2f4b6bd 100644 (file)
@@ -35,9 +35,9 @@
 .\" Updated Tue 16 Nov 1999 by NAKANO Takeo
 .\"
 .TH UUID_GENERATE 3 "December 2010" "E2fsprogs version 1.41.14"
-.SH Ì¾Á°
-uuid_generate, uuid_generate_random, uuid_generate_time \- Â¾¤È½Å¤Ê¤é¤Ê¤¤ UUID Ãͤò¿·¤·¤¯ºîÀ®¤¹¤ë
-.SH ½ñ¼°
+.SH 名前
+uuid_generate, uuid_generate_random, uuid_generate_time \- 他と重ならない UUID 値を新しく作成する
+.SH 書式
 .nf
 .B #include <uuid/uuid.h>
 .sp
@@ -45,59 +45,59 @@ uuid_generate, uuid_generate_random, uuid_generate_time \- ¾
 .BI "void uuid_generate_random(uuid_t " out );
 .BI "void uuid_generate_time(uuid_t " out );
 .fi
-.SH ÀâÌÀ
+.SH 説明
 .B uuid_generate
-´Ø¿ô¤Ï¿·¤·¤¤ UUID (universally unique identifier:
-ÀäÂФ˾¤È¤Ï½Å¤Ê¤é¤Ê¤¤¼±ÊÌ»Ò) ¤òÀ¸À®¤¹¤ë¡£
-UUID ¤ÎÀ¸À®¤Ë¤Ï¡¢
+関数は新しい UUID (universally unique identifier:
+絶対に他とは重ならない識別子) を生成する。
+UUID の生成には、
 .I /dev/urandom
-¤Î¤è¤¦¤Ê¼Á¤ÎÎɤ¤Íð¿ôȯÀ¸µ¡¹½¤¬ÍøÍѤǤ­¤ë¾ì¹ç¤Ï¤½¤ì¤òÍøÍѤ¹¤ë¡£
-¤Ç¤­¤Ê¤¤¾ì¹ç¤Ë¤Ï¡¢
+のような質の良い乱数発生機構が利用できる場合はそれを利用する。
+できない場合には、
 .B uuid_generate
-¤ÏÊ̤Υ¢¥ë¥´¥ê¥º¥à¤òÍѤ¤¤ë¡£¤³¤Î¾ì¹ç¤Ï¸½ºß»þ¹ï¡¢
-¥í¡¼¥«¥ë¤Ê¥¤¡¼¥µ¥Í¥Ã¥È¤Î MAC ¥¢¥É¥ì¥¹¤¬¼èÆÀ¤Ç¤­¤ì¤Ð¤½¤ÎÃÍ¡¢
-¤ª¤è¤Óµ¼»÷Íð¿ôȯÀ¸µ¡¹½¤«¤éÀ¸À®¤µ¤ì¤¿Íð¿ô¤¬ÍѤ¤¤é¤ì¤ë¡£
+は別のアルゴリズムを用いる。この場合は現在時刻、
+ローカルなイーサネットの MAC アドレスが取得できればその値、
+および擬似乱数発生機構から生成された乱数が用いられる。
 .sp
 .B uuid_generate_random
-´Ø¿ô¤Ï¡¢¼Á¤ÎÎɤ¤Íð¿ôȯÀ¸µ¡¹½ (Î㤨¤Ð
+関数は、質の良い乱数発生機構 (例えば
 .IR /dev/urandom )
-¤¬ÍøÍѤǤ­¤Ê¤¤¾ì¹ç¤Ç¤â¡¢´°Á´¤Ë¥é¥ó¥À¥à¥Ù¡¼¥¹¤Î (¤Ä¤Þ¤ê»þ¹ï¤ä
-MAC ¥¢¥É¥ì¥¹¤ò»È¤ï¤Ê¤¤) UUID ¥Õ¥©¡¼¥Þ¥Ã¥È¤òºî¤ê¤¿¤¤¾ì¹ç¤ËÍѤ¤¤ë¡£
-¤³¤Î¾ì¹ç¤Ïµ¼»÷Íð¿ôȯÀ¸µ¡¹½¤¬Âå¤ï¤ê¤ËÍѤ¤¤é¤ì¤ë¡£
-µ¼»÷Íð¿ôȯÀ¸µ¡¹½¤òÍøÍѤ¹¤ë¤È¡¢¤³¤Î¤è¤¦¤ËÀ¸À®¤µ¤ì¤¿ UUID ¤Î
-°ì°ÕÀ­¤ÏÎô²½¤¹¤ë¤«¤â¤·¤ì¤Ê¤¤¤³¤È¤ËÃí°Õ¤¹¤ë¤³¤È¡£
+が利用できない場合でも、完全にランダムベースの (つまり時刻や
+MAC アドレスを使わない) UUID フォーマットを作りたい場合に用いる。
+この場合は擬似乱数発生機構が代わりに用いられる。
+擬似乱数発生機構を利用すると、このように生成された UUID の
+一意性は劣化するかもしれないことに注意すること。
 .sp
 .B uuid_generata_time
-´Ø¿ô¤Ï¡¢ÂåÂØ¥¢¥ë¥´¥ê¥º¥à¤ò»È¤¤¤¿¤¤¾ì¹ç¤ËÍѤ¤¤ë¡£
-¤³¤ì¤Ï¸½ºß»þ¹ï¤È (¤¢¤ì¤Ð) ¥¤¡¼¥µ¥Í¥Ã¥È¤Î MAC ¥¢¥É¥ì¥¹¤òÍѤ¤¤ë¡£
-¤³¤Î¥¢¥ë¥´¥ê¥º¥à¤Ï¤«¤Ä¤Æ UUID À¸À®ÊýË¡¤Î¥Ç¥Õ¥©¥ë¥È¤Ç¤¢¤Ã¤¿¤¬¡¢
-¥¤¡¼¥µ¥Í¥Ã¥È¤Î MAC ¥¢¥É¥ì¥¹¤òÍѤ¤¤ë¤Î¤Ç¡¢¤¤¤Ä¤É¤³¤Ç UUID ¤¬À¸À®
-¤µ¤ì¤¿¤«¤Î¾ðÊ󤬥꡼¥¯¤·¤Æ¤·¤Þ¤¦¡£¤³¤ì¤Ï¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ë¤è¤Ã¤Æ¤Ï
-¥×¥é¥¤¥Ð¥·¡¼¤ÎÌäÂê¤òµ¯¤³¤¹¤³¤È¤¬¤¢¤ë¤Î¤Ç¡¢
+関数は、代替アルゴリズムを使いたい場合に用いる。
+これは現在時刻と (あれば) イーサネットの MAC アドレスを用いる。
+このアルゴリズムはかつて UUID 生成方法のデフォルトであったが、
+イーサネットの MAC アドレスを用いるので、いつどこで UUID が生成
+されたかの情報がリークしてしまう。これはアプリケーションによっては
+プライバシーの問題を起こすことがあるので、
 .B uuid_generate
-´Ø¿ô¤Ï¼Á¤Î¹â¤¤Íð¿ôȯÀ¸µ¡¹½¤¬ÍøÍѤǤ­¤Ê¤¤¾ì¹ç¤Ë¸Â¤Ã¤Æ
-¤³¤Î¥¢¥ë¥´¥ê¥º¥à¤òÍѤ¤¤ë¤è¤¦¤Ë¤Ê¤Ã¤¿¡£
+関数は質の高い乱数発生機構が利用できない場合に限って
+このアルゴリズムを用いるようになった。
 .sp
-UUID ¤Ï 16 ¥Ð¥¤¥È (128 ¥Ó¥Ã¥È) Ä¹¤Ç¡¢¤ª¤è¤½ 3.4x10^38 ¤³¤Î
-¥æ¥Ë¡¼¥¯¤ÊÃͤòÍ¿¤¨¤ë (Carl Segan ¤Î
+UUID は 16 バイト (128 ビット) 長で、およそ 3.4x10^38 この
+ユニークな値を与える (Carl Segan の
 .I Cosmos
-¤Ë¤è¤ì¤Ð¡¢Á´±§Ãè¤Ë¤¢¤ëÁÇγ»Ò¤Î¸Ä¿ô¤Ï 10^80 ¤À¤½¤¦¤Ç¤¢¤ë)¡£
-¿·¤¿¤Ëºî¤é¤ì¤¿ UUID ¤Ï¡¢¥í¡¼¥«¥ë¤Ê¥·¥¹¥Æ¥à¤ä³°Éô¤Î¥·¥¹¥Æ¥à¤Ë¤è¤Ã¤Æ
-²áµî¤Þ¤¿¤Ï̤Íè¤ËÀ¸À®¤µ¤ì¤¿/¤µ¤ì¤ë UUID ¤Î¤¤¤º¤ì¤È¤â°Û¤Ê¤ë¤È
-¹Í¤¨¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
-.SH ÊÖ¤êÃÍ
-¿·¤¿¤ËÀ¸À®¤µ¤ì¤¿ UUID ¤¬¡¢
+によれば、全宇宙にある素粒子の個数は 10^80 だそうである)。
+新たに作られた UUID は、ローカルなシステムや外部のシステムによって
+過去または未来に生成された/される UUID のいずれとも異なると
+考えることができる。
+.SH 返り値
+新たに生成された UUID が、
 .I out
-¤Î»Ø¤¹¥á¥â¥ê°ÌÃÖ¤ËÊÖ¤µ¤ì¤ë¡£
-.SH ½àµò
+の指すメモリ位置に返される。
+.SH 準拠
 OSF DCE 1.1
-.SH Ãø¼Ô
+.SH 著者
 Theodore Y. Ts'o
-.SH Æþ¼êÊýË¡
+.SH 入手方法
 .UR http://e2fsprogs.sourceforge.net/
 http://e2fsprogs.sourceforge.net/
 .UE
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
 .BR uuid (3),
 .BR uuidgen (1),
 .BR uuid_clear (3),