release/man7/x25.7

   1 .\" This man page is Copyright (C) 1998 Heiner Eisen.
   2 .\"
   3 .\" %%%LICENSE_START(VERBATIM_ONE_PARA)
   4 .\" Permission is granted to distribute possibly modified copies
   5 .\" of this page provided the header is included verbatim,
   6 .\" and in case of nontrivial modification author and date
   7 .\" of the modification is added to the header.
   8 .\" %%%LICENSE_END
   9 .\"
  10 .\" $Id: x25.7,v 1.4 1999/05/18 10:35:12 freitag Exp $
  11 .\"
  12 .\"*******************************************************************
  13 .\"
  14 .\" This file was generated with po4a. Translate the source file.
  15 .\"
  16 .\"*******************************************************************
  17 .\"
  18 .\" Japanese Version Copyright (c) 1999 NAKANO Takeo all rights reserved.
  19 .\" Translated Mon 6 Dec 1999 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
  20 .\"
  21 .TH X25 7 2012\-08\-05 Linux "Linux Programmer's Manual"
  22 .SH 名前
  23 x25 \- ITU\-T X.25 / ISO\-8208 プロトコルインターフェース
  24 .SH 書式
  25 \fB#include <sys/socket.h>\fP
  26 .br
  27 \fB#include <linux/x25.h>\fP
  28 .sp
  29 \fBx25_socket = socket(AF_X25, SOCK_SEQPACKET, 0);\fP
  30 .SH 説明
  31 X25 ソケットは X.25 パケット層プロトコルに対するインターフェースを提供する。 これにより、アプリケーションはパブリックな X.25
  32 データネットワークで 通信することができるようになる。 X.25 は International Telecommunication Union's
  33 recommendation X.25 (X.25 DTE\-DCE mode) で標準化されている。 X25 ソケットは、中間層のない X.25
  34 ネットワーク (X.25 DTE\-DTE mode)  での通信にも用いることができる。 DTE\-DTE モードは ISO\-8208 に記述されている。
  35 .PP
  36 メッセージ境界は保存される。ソケットからの \fBread\fP(2)  は、反対側のソケットからの対応する \fBwrite\fP(2)
  37 と同じ大きさのデータを受け取り、出力する。 必要がある場合は、カーネルが長いメッセージの 分割 (segmenting) と再構成
  38 (reassembling) を行う。 これには X.25 の M ビットが用いられる。 メッセージサイズには、ハードコーディングされた上限はない。
  39 しかし、一時的にシステムリソースが足りなかったり、 他の制約 (ソケットメモリーバッファーのサイズ制限など) が
  40 効いてしまうと、長いメッセージの再構成には失敗するかもしれない。 この場合、その X.25 接続はリセットされることになる。
  41 .SS ソケットアドレス
  42 \fBAF_X25\fP ソケットアドレスファミリーは、ネットワークアドレスを表すために \fIstruct sockaddr_x25\fP を用いる。これは
  43 ITU\-T recommendation X.121 で定義されている。
  44 .PP
  45 .in +4n
  46 .nf
  47 struct sockaddr_x25 {
  48     sa_family_t sx25_family;    /* must be AF_X25 */
  49     x25_address sx25_addr;      /* X.121 Address */
  50 };
  51 .fi
  52 .in
  53 .PP
  54 \fIsx25_addr\fP には char 配列 \fIx25_addr[]\fP を含まれる。これは 0 で終端する文字列として解釈される。
  55 \fIsx25_addr.x25_addr[]\fP は 15 個までの ASCII 文字を含むことができ (終端のヌルバイトは含まない)、 これが
  56 X.121 アドレスをなす。 10 進の数文字、\(aq0\(aq から \(aq9\(aq までだけが許される。
  57 .SS ソケットオプション
  58 以下の X.25 特有のソケットオプションは、 \fBsetsockopt\fP(2)  で設定でき、 \fBgetsockopt\fP(2)
  59 で取得できる。このとき \fIlevel\fP 引き数には \fBSOL_X25\fP を指定する。
  60 .TP
  61 \fBX25_QBITINCL\fP
  62 X.25 の Q ビット (Qualified データビット) にユーザーがアクセス できるかどうかをコントロールする。整数の引数を取る。 0
  63 にセットすると、 Q ビットは発信パケットには決してセットされず、 受信パケットでは無視される (デフォルト)。 1
  64 にセットすると、ソケットから読む、あるいはソケットに送る メッセージそれぞれに先頭バイトが前置される。 ソケットから読んだデータでは、先頭バイトが 0
  65 だと、 この到着データパケットに対応する Q ビットはセットされていなかったことになる。 先頭バイトが 1 だと、到着データパケットの Q
  66 ビットがセットされていたことになる。 ソケットに書き込むデータの先頭バイトが 1 だと、 その発信パケットの Q ビットをセットする。 0 だと、 Q
  67 ビットをセットしない。
  68 .SH バージョン
  69 AF_X25 プロトコルファミリーは Linux 2.2 の新機能である。
  70 .SH バグ
  71 X.25 PLP 実装は \fBCONFIG_EXPERIMENTAL\fP なので、たくさんあるだろう。
  72 .PP
  73 この man ページは完成していない。
  74 .PP
  75 まだアプリケーションプログラマー用のヘッダーファイルがない。 カーネルのヘッダーファイル \fI<linux/x25.h>\fP
  76 をインクルードしなければならない。 \fBCONFIG_EXPERIMENTAL\fP なので、将来のバージョンのインターフェースでは
  77 バイナリ互換性が失われるかもしれない。
  78 .PP
  79 X.25 N\-Reset イベントは、まだユーザープロセスに伝播しない。 したがってリセットが起こると、データは通知無しに失われる。
  80 .SH 関連項目
  81 \fBsocket\fP(2), \fBsocket\fP(7)
  82 .PP
  83 Jonathan Simon Naylor: \(lqThe Re\-Analysis and Re\-Implementation of
  84 X.25.\(rq The URL is
  85 .UR ftp://ftp.pspt.fi\:/pub\:/ham\:/linux\:/ax25\:/x25doc.tgz
  86 .UE .
  87 .SH この文書について
  88 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
  89 である。プロジェクトの説明とバグ報告に関する情報は
  90 http://www.kernel.org/doc/man\-pages/ に書かれている。