OSDN Git Service

(split) LDP: draft snapshot generated from latest ja.po files.
[linuxjm/LDP_man-pages.git] / draft / man7 / x25.7
index d622632..c647a5a 100644 (file)
@@ -4,82 +4,34 @@
 .\" and in case of nontrivial modification author and date
 .\" of the modification is added to the header.
 .\" $Id: x25.7,v 1.4 1999/05/18 10:35:12 freitag Exp $
+.\"*******************************************************************
 .\"
-.\" Japanese Version Copyright (c) 1999 NAKANO Takeo all rights reserved.
-.\" Translated Mon 6 Dec 1999 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH X25 7 2008-08-08 "Linux" "Linux Programmer's Manual"
-.\"O .SH NAME
-.\"O x25, AF_X25 \- ITU-T X.25 / ISO-8208 protocol interface.
-.SH Ì¾Á°
-x25, AF_X25 \- ITU-T X.25 / ISO-8208 ¥×¥í¥È¥³¥ë¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
-.B #include <sys/socket.h>
+.\"*******************************************************************
+.TH X25 7 2008\-08\-08 Linux "Linux Programmer's Manual"
+.SH 名前
+x25, AF_X25 \- ITU\-T X.25 / ISO\-8208 プロトコルインターフェース
+.SH 書式
+\fB#include <sys/socket.h>\fP
 .br
-.B #include <linux/x25.h>
+\fB#include <linux/x25.h>\fP
 .sp
-.B x25_socket = socket(AF_X25, SOCK_SEQPACKET, 0);
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O X25 sockets provide an interface to the X.25 packet layer protocol.
-.\"O This allows applications to
-.\"O communicate over a public X.25 data network as standardized by
-.\"O International Telecommunication Union's recommendation X.25
-.\"O (X.25 DTE-DCE mode).
-.\"O X25 sockets can also be used for communication
-.\"O without an intermediate X.25 network (X.25 DTE-DTE mode) as described
-.\"O in ISO-8208.
-X25 ¥½¥±¥Ã¥È¤Ï X.25 ¥Ñ¥±¥Ã¥ÈÁØ¥×¥í¥È¥³¥ë¤ËÂФ¹¤ë¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹¤òÄ󶡤¹¤ë¡£
-¤³¤ì¤Ë¤è¤ê¡¢¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤Ï¥Ñ¥Ö¥ê¥Ã¥¯¤Ê X.25 ¥Ç¡¼¥¿¥Í¥Ã¥È¥ï¡¼¥¯¤Ç
-ÄÌ¿®¤¹¤ë¤³¤È¤¬¤Ç¤­¤ë¤è¤¦¤Ë¤Ê¤ë¡£ X.25 ¤Ï
-International Telecommunication Union's recommendation X.25
-(X.25 DTE-DCE mode) ¤Çɸ½à²½¤µ¤ì¤Æ¤¤¤ë¡£
-X25 ¥½¥±¥Ã¥È¤Ï¡¢Ãæ´ÖÁؤΤʤ¤ X.25 ¥Í¥Ã¥È¥ï¡¼¥¯ (X.25 DTE-DTE mode)
-¤Ç¤ÎÄÌ¿®¤Ë¤âÍѤ¤¤ë¤³¤È¤¬¤Ç¤­¤ë¡£
-DTE-DTE ¥â¡¼¥É¤Ï ISO-8208 ¤Ëµ­½Ò¤µ¤ì¤Æ¤¤¤ë¡£
+\fBx25_socket = socket(AF_X25, SOCK_SEQPACKET, 0);\fP
+.SH 説明
+X25 ソケットは X.25 パケット層プロトコルに対するインターフェースを提供する。 これにより、アプリケーションはパブリックな X.25
+データネットワークで 通信することができるようになる。 X.25 は International Telecommunication Union's
+recommendation X.25 (X.25 DTE\-DCE mode) で標準化されている。 X25 ソケットは、中間層のない X.25
+ネットワーク (X.25 DTE\-DTE mode)  での通信にも用いることができる。 DTE\-DTE モードは ISO\-8208 に記述されている。
 .PP
-.\"O Message boundaries are preserved \(em a
-.\"O .BR read (2)
-.\"O from a socket will
-.\"O retrieve the same chunk of data as output with the corresponding
-.\"O .BR write (2)
-.\"O to the peer socket.
-.\"O When necessary, the kernel takes care
-.\"O of segmenting and reassembling long messages by means of
-.\"O the X.25 M-bit.
-.\"O There is no hard-coded upper limit for the
-.\"O message size.
-.\"O However, reassembling of a long message might fail if
-.\"O there is a temporary lack of system resources or when other constraints
-.\"O (such as socket memory or buffer size limits) become effective.
-.\"O If that
-.\"O occurs, the X.25 connection will be reset.
-¥á¥Ã¥»¡¼¥¸¶­³¦¤ÏÊݸ¤µ¤ì¤ë¡£¥½¥±¥Ã¥È¤«¤é¤Î
-.BR read (2)
-¤Ï¡¢È¿ÂЦ¤Î¥½¥±¥Ã¥È¤«¤é¤ÎÂбþ¤¹¤ë
-.BR write (2)
-¤ÈƱ¤¸Â礭¤µ¤Î¥Ç¡¼¥¿¤ò¼õ¤±¼è¤ê¡¢½ÐÎϤ¹¤ë¡£
-ɬÍפ¬¤¢¤ë¾ì¹ç¤Ï¡¢¥«¡¼¥Í¥ë¤¬Ä¹¤¤¥á¥Ã¥»¡¼¥¸¤Î
-ʬ³ä (segmenting) ¤ÈºÆ¹½À® (reassembling) ¤ò¹Ô¤¦¡£
-¤³¤ì¤Ë¤Ï X.25 ¤Î M ¥Ó¥Ã¥È¤¬ÍѤ¤¤é¤ì¤ë¡£
-¥á¥Ã¥»¡¼¥¸¥µ¥¤¥º¤Ë¤Ï¡¢¥Ï¡¼¥É¥³¡¼¥Ç¥£¥ó¥°¤µ¤ì¤¿¾å¸Â¤Ï¤Ê¤¤¡£
-¤·¤«¤·¡¢°ì»þŪ¤Ë¥·¥¹¥Æ¥à¥ê¥½¡¼¥¹¤¬Â­¤ê¤Ê¤«¤Ã¤¿¤ê¡¢
-¾¤ÎÀ©Ìó (¥½¥±¥Ã¥È¥á¥â¥ê¥Ð¥Ã¥Õ¥¡¤Î¥µ¥¤¥ºÀ©¸Â¤Ê¤É) ¤¬
-¸ú¤¤¤Æ¤·¤Þ¤¦¤È¡¢Ä¹¤¤¥á¥Ã¥»¡¼¥¸¤ÎºÆ¹½À®¤Ë¤Ï¼ºÇÔ¤¹¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
-¤³¤Î¾ì¹ç¡¢¤½¤Î X.25 Àܳ¤Ï¥ê¥»¥Ã¥È¤µ¤ì¤ë¤³¤È¤Ë¤Ê¤ë¡£
-.\"O .SS Socket Addresses
-.SS ¥½¥±¥Ã¥È¥¢¥É¥ì¥¹
-.\"O The
-.\"O .B AF_X25
-.\"O socket address family uses the
-.\"O .I struct sockaddr_x25
-.\"O for representing network addresses as defined in ITU-T
-.\"O recommendation X.121.
-.B AF_X25
-¥½¥±¥Ã¥È¥¢¥É¥ì¥¹¥Õ¥¡¥ß¥ê¡¼¤Ï¡¢¥Í¥Ã¥È¥ï¡¼¥¯¥¢¥É¥ì¥¹¤òɽ¤¹¤¿¤á¤Ë
-.I struct sockaddr_x25
-¤òÍѤ¤¤ë¡£¤³¤ì¤Ï ITU-T recommendation X.121 ¤ÇÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
+メッセージ境界は保存される。ソケットからの \fBread\fP(2)  は、反対側のソケットからの対応する \fBwrite\fP(2)
+と同じ大きさのデータを受け取り、出力する。 必要がある場合は、カーネルが長いメッセージの 分割 (segmenting) と再構成
+(reassembling) を行う。 これには X.25 の M ビットが用いられる。 メッセージサイズには、ハードコーディングされた上限はない。
+しかし、一時的にシステムリソースが足りなかったり、 他の制約 (ソケットメモリバッファのサイズ制限など) が
+効いてしまうと、長いメッセージの再構成には失敗するかもしれない。 この場合、その X.25 接続はリセットされることになる。
+.SS ソケットアドレス
+\fBAF_X25\fP ソケットアドレスファミリーは、ネットワークアドレスを表すために \fIstruct sockaddr_x25\fP を用いる。これは
+ITU\-T recommendation X.121 で定義されている。
 .PP
 .in +4n
 .nf
@@ -90,117 +42,36 @@ struct sockaddr_x25 {
 .fi
 .in
 .PP
-.\"O .I sx25_addr
-.\"O contains a char array
-.\"O .I x25_addr[]
-.\"O to be interpreted as a null-terminated string.
-.\"O .I sx25_addr.x25_addr[]
-.\"O consists of up to 15 (not counting the terminating 0) ASCII
-.\"O characters forming the X.121 address.
-.\"O Only the decimal digit characters from \(aq0\(aq to \(aq9\(aq are allowed.
-.I sx25_addr
-¤Ë¤Ï char ÇÛÎó
-.I x25_addr[]
-¤ò´Þ¤Þ¤ì¤ë¡£¤³¤ì¤Ï 0 ¤Ç½ªÃ¼¤¹¤ëʸ»úÎó¤È¤·¤Æ²ò¼á¤µ¤ì¤ë¡£
-.I sx25_addr.x25_addr[]
-¤Ï 15 ¸Ä¤Þ¤Ç¤Î ASCII Ê¸»ú¤ò´Þ¤à¤³¤È¤¬¤Ç¤­ (½ªÃ¼¤Î 0 ¤Ï´Þ¤Þ¤Ê¤¤)¡¢
-¤³¤ì¤¬ X.121 ¥¢¥É¥ì¥¹¤ò¤Ê¤¹¡£
-10 ¿Ê¤Î¿ôʸ»ú¡¢\(aq0\(aq ¤«¤é \(aq9\(aq ¤Þ¤Ç¤À¤±¤¬µö¤µ¤ì¤ë¡£
-.\"O .SS Socket Options
-.SS ¥½¥±¥Ã¥È¥ª¥×¥·¥ç¥ó
-.\"O The following X.25-specific socket options can be set by using
-.\"O .BR setsockopt (2)
-.\"O and read with
-.\"O .BR getsockopt (2)
-.\"O with the
-.\"O .I level
-.\"O argument set to
-.\"O .BR SOL_X25 .
-°Ê²¼¤Î X.25 ÆÃÍ­¤Î¥½¥±¥Ã¥È¥ª¥×¥·¥ç¥ó¤Ï¡¢
-.BR setsockopt (2)
-¤ÇÀßÄê¤Ç¤­¡¢
-.BR getsockopt (2)
-¤Ç¼èÆÀ¤Ç¤­¤ë¡£¤³¤Î¤È¤­
-.I level
-°ú¤­¿ô¤Ë¤Ï
-.B SOL_X25
-¤ò»ØÄꤹ¤ë¡£
-.TP
-.B X25_QBITINCL
-.\"O Controls whether the X.25 Q-bit (Qualified Data Bit) is accessible by the
-.\"O user.
-.\"O It expects an integer argument.
-.\"O If set to 0 (default),
-.\"O the Q-bit is never set for outgoing packets and the Q-bit of incoming
-.\"O packets is ignored.
-.\"O If set to 1, an additional first byte is prepended
-.\"O to each message read from or written to the socket.
-.\"O For data read from
-.\"O the socket, a 0 first byte indicates that the Q-bits of the corresponding
-.\"O incoming data packets were not set.
-.\"O A first byte with value 1 indicates
-.\"O that the Q-bit of the corresponding incoming data packets was set.
-.\"O If the first byte of the data written to the socket is 1 the Q-bit of the
-.\"O corresponding outgoing data packets will be set.
-.\"O If the first byte is 0
-.\"O the Q-bit will not be set.
-X.25 ¤Î Q ¥Ó¥Ã¥È (Qualified ¥Ç¡¼¥¿¥Ó¥Ã¥È) ¤Ë¥æ¡¼¥¶¡¼¤¬¥¢¥¯¥»¥¹
-¤Ç¤­¤ë¤«¤É¤¦¤«¤ò¥³¥ó¥È¥í¡¼¥ë¤¹¤ë¡£À°¿ô¤Î°ú¿ô¤ò¼è¤ë¡£
-0 ¤Ë¥»¥Ã¥È¤¹¤ë¤È¡¢ Q ¥Ó¥Ã¥È¤Ïȯ¿®¥Ñ¥±¥Ã¥È¤Ë¤Ï·è¤·¤Æ¥»¥Ã¥È¤µ¤ì¤º¡¢
-¼õ¿®¥Ñ¥±¥Ã¥È¤Ç¤Ï̵»ë¤µ¤ì¤ë (¥Ç¥Õ¥©¥ë¥È)¡£
-1 ¤Ë¥»¥Ã¥È¤¹¤ë¤È¡¢¥½¥±¥Ã¥È¤«¤éÆɤࡢ¤¢¤ë¤¤¤Ï¥½¥±¥Ã¥È¤ËÁ÷¤ë
-¥á¥Ã¥»¡¼¥¸¤½¤ì¤¾¤ì¤ËÀèƬ¥Ð¥¤¥È¤¬Á°ÃÖ¤µ¤ì¤ë¡£
-¥½¥±¥Ã¥È¤«¤éÆɤó¤À¥Ç¡¼¥¿¤Ç¤Ï¡¢ÀèƬ¥Ð¥¤¥È¤¬ 0 ¤À¤È¡¢
-¤³¤ÎÅþÃå¥Ç¡¼¥¿¥Ñ¥±¥Ã¥È¤ËÂбþ¤¹¤ë Q ¥Ó¥Ã¥È¤Ï¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤Ê¤«¤Ã¤¿¤³¤È¤Ë¤Ê¤ë¡£
-ÀèƬ¥Ð¥¤¥È¤¬ 1 ¤À¤È¡¢ÅþÃå¥Ç¡¼¥¿¥Ñ¥±¥Ã¥È¤Î
-Q ¥Ó¥Ã¥È¤¬¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤¿¤³¤È¤Ë¤Ê¤ë¡£
-¥½¥±¥Ã¥È¤Ë½ñ¤­¹þ¤à¥Ç¡¼¥¿¤ÎÀèƬ¥Ð¥¤¥È¤¬ 1 ¤À¤È¡¢
-¤½¤Îȯ¿®¥Ñ¥±¥Ã¥È¤Î Q ¥Ó¥Ã¥È¤ò¥»¥Ã¥È¤¹¤ë¡£
-0 ¤À¤È¡¢ Q ¥Ó¥Ã¥È¤ò¥»¥Ã¥È¤·¤Ê¤¤¡£
-.\"O .SH VERSIONS
-.SH ¥Ð¡¼¥¸¥ç¥ó
-.\"O The AF_X25 protocol family is a new feature of Linux 2.2.
-AF_X25 ¥×¥í¥È¥³¥ë¥Õ¥¡¥ß¥ê¤Ï Linux 2.2 ¤Î¿·µ¡Ç½¤Ç¤¢¤ë¡£
-.\"O .SH BUGS
-.SH ¥Ð¥°
-.\"O Plenty, as the X.25 PLP implementation is
-.\"O .BR CONFIG_EXPERIMENTAL .
-X.25 PLP ¼ÂÁõ¤Ï
-.B CONFIG_EXPERIMENTAL
-¤Ê¤Î¤Ç¡¢¤¿¤¯¤µ¤ó¤¢¤ë¤À¤í¤¦¡£
+\fIsx25_addr\fP には char 配列 \fIx25_addr[]\fP を含まれる。これは 0 で終端する文字列として解釈される。
+\fIsx25_addr.x25_addr[]\fP は 15 個までの ASCII 文字を含むことができ (終端の 0 は含まない)、 これが X.121
+アドレスをなす。 10 進の数文字、\(aq0\(aq から \(aq9\(aq までだけが許される。
+.SS ソケットオプション
+以下の X.25 特有のソケットオプションは、 \fBsetsockopt\fP(2)  で設定でき、 \fBgetsockopt\fP(2)
+で取得できる。このとき \fIlevel\fP 引き数には \fBSOL_X25\fP を指定する。
+.TP 
+\fBX25_QBITINCL\fP
+X.25 の Q ビット (Qualified データビット) にユーザーがアクセス できるかどうかをコントロールする。整数の引数を取る。 0
+にセットすると、 Q ビットは発信パケットには決してセットされず、 受信パケットでは無視される (デフォルト)。 1
+にセットすると、ソケットから読む、あるいはソケットに送る メッセージそれぞれに先頭バイトが前置される。 ソケットから読んだデータでは、先頭バイトが 0
+だと、 この到着データパケットに対応する Q ビットはセットされていなかったことになる。 先頭バイトが 1 だと、到着データパケットの Q
+ビットがセットされていたことになる。 ソケットに書き込むデータの先頭バイトが 1 だと、 その発信パケットの Q ビットをセットする。 0 だと、 Q
+ビットをセットしない。
+.SH バージョン
+AF_X25 プロトコルファミリは Linux 2.2 の新機能である。
+.SH バグ
+X.25 PLP 実装は \fBCONFIG_EXPERIMENTAL\fP なので、たくさんあるだろう。
 .PP
-.\"O This man page is incomplete.
-¤³¤Î man ¥Ú¡¼¥¸¤Ï´°À®¤·¤Æ¤¤¤Ê¤¤¡£
+この man ページは完成していない。
 .PP
-.\"O There is no dedicated application programmer's header file yet;
-.\"O you need to include the kernel header file
-.\"O .IR <linux/x25.h> .
-.\"O .B CONFIG_EXPERIMENTAL
-.\"O might also imply that future versions of the
-.\"O interface are not binary compatible.
-¤Þ¤À¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¥×¥í¥°¥é¥Þ¡¼ÍѤΥإåÀ¥Õ¥¡¥¤¥ë¤¬¤Ê¤¤¡£
-¥«¡¼¥Í¥ë¤Î¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë
-.I <linux/x25.h>
-¤ò¥¤¥ó¥¯¥ë¡¼¥É¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
-.B CONFIG_EXPERIMENTAL
-¤Ê¤Î¤Ç¡¢¾­Íè¤Î¥Ð¡¼¥¸¥ç¥ó¤Î¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹¤Ç¤Ï
-¥Ð¥¤¥Ê¥ê¸ß´¹À­¤¬¼º¤ï¤ì¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
+まだアプリケーションプログラマー用のヘッダファイルがない。 カーネルのヘッダファイル \fI<linux/x25.h>\fP
+をインクルードしなければならない。 \fBCONFIG_EXPERIMENTAL\fP なので、将来のバージョンのインターフェースでは
+バイナリ互換性が失われるかもしれない。
 .PP
-.\"O X.25 N-Reset events are not propagated to the user process yet.
-.\"O Thus,
-.\"O if a reset occurred, data might be lost without notice.
-X.25 N-Reset ¥¤¥Ù¥ó¥È¤Ï¡¢¤Þ¤À¥æ¡¼¥¶¡¼¥×¥í¥»¥¹¤ËÅÁÇŤ·¤Ê¤¤¡£
-¤·¤¿¤¬¤Ã¤Æ¥ê¥»¥Ã¥È¤¬µ¯¤³¤ë¤È¡¢¥Ç¡¼¥¿¤ÏÄÌÃÎ̵¤·¤Ë¼º¤ï¤ì¤ë¡£
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR socket (2),
-.BR socket (7)
+X.25 N\-Reset イベントは、まだユーザープロセスに伝播しない。 したがってリセットが起こると、データは通知無しに失われる。
+.SH 関連項目
+\fBsocket\fP(2), \fBsocket\fP(7)
 .PP
-Jonathan Simon Naylor:
-.\"O \(lqThe Re-Analysis and Re-Implementation of X.25.\(rq
-\(lqX.25 ¤ÎºÆʬÀϤȺƼÂÁõ\(rq
-.\"O The URL is
+Jonathan Simon Naylor: \(lqX.25 の再分析と再実装\(rq
 .RS
-URL ¤Ï
-.I ftp://ftp.pspt.fi/pub/ham/linux/ax25/x25doc.tgz
+URL は \fIftp://ftp.pspt.fi/pub/ham/linux/ax25/x25doc.tgz\fP
 .RE