draft/man7/x25.7

   1 .\" This man page is Copyright (C) 1998 Heiner Eisen.
   2 .\" Permission is granted to distribute possibly modified copies
   3 .\" of this page provided the header is included verbatim,
   4 .\" and in case of nontrivial modification author and date
   5 .\" of the modification is added to the header.
   6 .\" $Id: x25.7,v 1.4 1999/05/18 10:35:12 freitag Exp $
   7 .\"
   8 .\" Japanese Version Copyright (c) 1999 NAKANO Takeo all rights reserved.
   9 .\" Translated Mon 6 Dec 1999 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
  10 .\"
  11 .TH X25 7 2008-08-08 "Linux" "Linux Programmer's Manual"
  12 .\"O .SH NAME
  13 .\"O x25, AF_X25 \- ITU-T X.25 / ISO-8208 protocol interface.
  14 .SH 名前
  15 x25, AF_X25 \- ITU-T X.25 / ISO-8208 プロトコルインターフェース
  16 .\"O .SH SYNOPSIS
  17 .SH 書式
  18 .B #include <sys/socket.h>
  19 .br
  20 .B #include <linux/x25.h>
  21 .sp
  22 .B x25_socket = socket(AF_X25, SOCK_SEQPACKET, 0);
  23 .\"O .SH DESCRIPTION
  24 .SH 説明
  25 .\"O X25 sockets provide an interface to the X.25 packet layer protocol.
  26 .\"O This allows applications to
  27 .\"O communicate over a public X.25 data network as standardized by
  28 .\"O International Telecommunication Union's recommendation X.25
  29 .\"O (X.25 DTE-DCE mode).
  30 .\"O X25 sockets can also be used for communication
  31 .\"O without an intermediate X.25 network (X.25 DTE-DTE mode) as described
  32 .\"O in ISO-8208.
  33 X25 ソケットは X.25 パケット層プロトコルに対するインターフェースを提供する。
  34 これにより、アプリケーションはパブリックな X.25 データネットワークで
  35 通信することができるようになる。 X.25 は
  36 International Telecommunication Union's recommendation X.25
  37 (X.25 DTE-DCE mode) で標準化されている。
  38 X25 ソケットは、中間層のない X.25 ネットワーク (X.25 DTE-DTE mode)
  39 での通信にも用いることができる。
  40 DTE-DTE モードは ISO-8208 に記述されている。
  41 .PP
  42 .\"O Message boundaries are preserved \(em a
  43 .\"O .BR read (2)
  44 .\"O from a socket will
  45 .\"O retrieve the same chunk of data as output with the corresponding
  46 .\"O .BR write (2)
  47 .\"O to the peer socket.
  48 .\"O When necessary, the kernel takes care
  49 .\"O of segmenting and reassembling long messages by means of
  50 .\"O the X.25 M-bit.
  51 .\"O There is no hard-coded upper limit for the
  52 .\"O message size.
  53 .\"O However, reassembling of a long message might fail if
  54 .\"O there is a temporary lack of system resources or when other constraints
  55 .\"O (such as socket memory or buffer size limits) become effective.
  56 .\"O If that
  57 .\"O occurs, the X.25 connection will be reset.
  58 メッセージ境界は保存される。ソケットからの
  59 .BR read (2)
  60 は、反対側のソケットからの対応する
  61 .BR write (2)
  62 と同じ大きさのデータを受け取り、出力する。
  63 必要がある場合は、カーネルが長いメッセージの
  64 分割 (segmenting) と再構成 (reassembling) を行う。
  65 これには X.25 の M ビットが用いられる。
  66 メッセージサイズには、ハードコーディングされた上限はない。
  67 しかし、一時的にシステムリソースが足りなかったり、
  68 他の制約 (ソケットメモリバッファのサイズ制限など) が
  69 効いてしまうと、長いメッセージの再構成には失敗するかもしれない。
  70 この場合、その X.25 接続はリセットされることになる。
  71 .\"O .SS Socket Addresses
  72 .SS ソケットアドレス
  73 .\"O The
  74 .\"O .B AF_X25
  75 .\"O socket address family uses the
  76 .\"O .I struct sockaddr_x25
  77 .\"O for representing network addresses as defined in ITU-T
  78 .\"O recommendation X.121.
  79 .B AF_X25
  80 ソケットアドレスファミリーは、ネットワークアドレスを表すために
  81 .I struct sockaddr_x25
  82 を用いる。これは ITU-T recommendation X.121 で定義されている。
  83 .PP
  84 .in +4n
  85 .nf
  86 struct sockaddr_x25 {
  87     sa_family_t sx25_family;    /* must be AF_X25 */
  88     x25_address sx25_addr;      /* X.121 Address */
  89 };
  90 .fi
  91 .in
  92 .PP
  93 .\"O .I sx25_addr
  94 .\"O contains a char array
  95 .\"O .I x25_addr[]
  96 .\"O to be interpreted as a null-terminated string.
  97 .\"O .I sx25_addr.x25_addr[]
  98 .\"O consists of up to 15 (not counting the terminating 0) ASCII
  99 .\"O characters forming the X.121 address.
 100 .\"O Only the decimal digit characters from \(aq0\(aq to \(aq9\(aq are allowed.
 101 .I sx25_addr
 102 には char 配列
 103 .I x25_addr[]
 104 を含まれる。これは 0 で終端する文字列として解釈される。
 105 .I sx25_addr.x25_addr[]
 106 は 15 個までの ASCII 文字を含むことができ (終端の 0 は含まない)、
 107 これが X.121 アドレスをなす。
 108 10 進の数文字、\(aq0\(aq から \(aq9\(aq までだけが許される。
 109 .\"O .SS Socket Options
 110 .SS ソケットオプション
 111 .\"O The following X.25-specific socket options can be set by using
 112 .\"O .BR setsockopt (2)
 113 .\"O and read with
 114 .\"O .BR getsockopt (2)
 115 .\"O with the
 116 .\"O .I level
 117 .\"O argument set to
 118 .\"O .BR SOL_X25 .
 119 以下の X.25 特有のソケットオプションは、
 120 .BR setsockopt (2)
 121 で設定でき、
 122 .BR getsockopt (2)
 123 で取得できる。このとき
 124 .I level
 125 引き数には
 126 .B SOL_X25
 127 を指定する。
 128 .TP
 129 .B X25_QBITINCL
 130 .\"O Controls whether the X.25 Q-bit (Qualified Data Bit) is accessible by the
 131 .\"O user.
 132 .\"O It expects an integer argument.
 133 .\"O If set to 0 (default),
 134 .\"O the Q-bit is never set for outgoing packets and the Q-bit of incoming
 135 .\"O packets is ignored.
 136 .\"O If set to 1, an additional first byte is prepended
 137 .\"O to each message read from or written to the socket.
 138 .\"O For data read from
 139 .\"O the socket, a 0 first byte indicates that the Q-bits of the corresponding
 140 .\"O incoming data packets were not set.
 141 .\"O A first byte with value 1 indicates
 142 .\"O that the Q-bit of the corresponding incoming data packets was set.
 143 .\"O If the first byte of the data written to the socket is 1 the Q-bit of the
 144 .\"O corresponding outgoing data packets will be set.
 145 .\"O If the first byte is 0
 146 .\"O the Q-bit will not be set.
 147 X.25 の Q ビット (Qualified データビット) にユーザーがアクセス
 148 できるかどうかをコントロールする。整数の引数を取る。
 149 0 にセットすると、 Q ビットは発信パケットには決してセットされず、
 150 受信パケットでは無視される (デフォルト)。
 151 1 にセットすると、ソケットから読む、あるいはソケットに送る
 152 メッセージそれぞれに先頭バイトが前置される。
 153 ソケットから読んだデータでは、先頭バイトが 0 だと、
 154 この到着データパケットに対応する Q ビットはセットされていなかったことになる。
 155 先頭バイトが 1 だと、到着データパケットの
 156 Q ビットがセットされていたことになる。
 157 ソケットに書き込むデータの先頭バイトが 1 だと、
 158 その発信パケットの Q ビットをセットする。
 159 0 だと、 Q ビットをセットしない。
 160 .\"O .SH VERSIONS
 161 .SH バージョン
 162 .\"O The AF_X25 protocol family is a new feature of Linux 2.2.
 163 AF_X25 プロトコルファミリは Linux 2.2 の新機能である。
 164 .\"O .SH BUGS
 165 .SH バグ
 166 .\"O Plenty, as the X.25 PLP implementation is
 167 .\"O .BR CONFIG_EXPERIMENTAL .
 168 X.25 PLP 実装は
 169 .B CONFIG_EXPERIMENTAL
 170 なので、たくさんあるだろう。
 171 .PP
 172 .\"O This man page is incomplete.
 173 この man ページは完成していない。
 174 .PP
 175 .\"O There is no dedicated application programmer's header file yet;
 176 .\"O you need to include the kernel header file
 177 .\"O .IR <linux/x25.h> .
 178 .\"O .B CONFIG_EXPERIMENTAL
 179 .\"O might also imply that future versions of the
 180 .\"O interface are not binary compatible.
 181 まだアプリケーションプログラマー用のヘッダファイルがない。
 182 カーネルのヘッダファイル
 183 .I <linux/x25.h>
 184 をインクルードしなければならない。
 185 .B CONFIG_EXPERIMENTAL
 186 なので、将来のバージョンのインターフェースでは
 187 バイナリ互換性が失われるかもしれない。
 188 .PP
 189 .\"O X.25 N-Reset events are not propagated to the user process yet.
 190 .\"O Thus,
 191 .\"O if a reset occurred, data might be lost without notice.
 192 X.25 N-Reset イベントは、まだユーザープロセスに伝播しない。
 193 したがってリセットが起こると、データは通知無しに失われる。
 194 .\"O .SH "SEE ALSO"
 195 .SH 関連項目
 196 .BR socket (2),
 197 .BR socket (7)
 198 .PP
 199 Jonathan Simon Naylor:
 200 .\"O \(lqThe Re-Analysis and Re-Implementation of X.25.\(rq
 201 \(lqX.25 の再分析と再実装\(rq
 202 .\"O The URL is
 203 .RS
 204 URL は
 205 .I ftp://ftp.pspt.fi/pub/ham/linux/ax25/x25doc.tgz
 206 .RE