Provided by: manpages-ja_0.5.0.0.20140515+dfsg-2_all 
名前
unix - ローカルな プロセス間通信用のソケット
書式
#include <sys/socket.h>
#include <sys/un.h>
unix_socket = socket(AF_UNIX, type, 0);
error = socketpair(AF_UNIX, type, 0, int *sv);
説明
AF_UNIX (AF_LOCAL とも言われる) ソケットファミリーは、同じマシン上で プロセス同士が 効率的
に通信するために用いられる。伝統的に、UNIX ドメイン ソケットは、名前なしにもできるし、 (ソ
ケット型であると印のついた) ファイル システムのパス名に 結び付けることもできる。さらに
Linux では、ファイル システムに依存しない抽象名前空間 (abstract namespace) もサポートして
いる。
有効なタイプを以下に示す。 SOCK_STREAM はストリーム指向のソケットである。 SOCK_DGRAM は
メッセージ境界を保存するデータグラム指向のソケットである (ほとんどの UNIX の実装では、UNIX
ドメイン・データグラム・ソケットは 常に 信頼でき、データグラムの並び替えは行わない)。
SOCK_SEQPACKET はメッセージ境界を保存し、送信された順序でメッセージを 届ける接続指向ソケッ
ト である (Linux 2.6.4 以降で利用できる)。
UNIX ドメインソケットでは、補助データを使って ファイルディスクリプタや プロセスの信任状
(credential) を 送受信することもできる。
アドレスのフォーマット
UNIX ドメインソケットのアドレスは以下の構造体で表現される。
#define UNIX_PATH_MAX 108
struct sockaddr_un {
sa_family_t sun_family; /* AF_UNIX */
char sun_path[UNIX_PATH_MAX]; /* pathname */
};
sun_family には必ず AF_UNIX が入っている。
この構造体では 3 種類のアドレスが区別される。
* pathname (パス名): bind(2) を使って、UNIX ドメインソケットをヌル終端されたファイルシス
テム上の パス名に結び付けることができる。 getsockname(2), getpeername(2), accept(2) が
ソケットのアドレスを返す際には、その長さは
offsetof(struct sockaddr_un, sun_path) + strlen(sun_path) + 1
であり、 sun_path にヌル終端されたパス名が格納される。
* unnamed (名前なし): bind(2) を使ってパス名に結び付けることができないストリーム型のソ
ケットは 名前を持たない。同様に、 socketpair(2) で作成される 2 つのソケットも名前を持
たない。 getsockname(2), getpeername(2), accept(2) が名前なしのソケットのアドレスを返
す際には、 その長さは sizeof(sa_family_t) であり、 sun_path は検査すべきではない。
* abstract (抽象): 抽象ソケットアドレスは、 sun_path[0] がヌルバイト ('\0') であることで
区別される。この名前空間におけるソケットのアドレス は、 sun_path の残りのバイトの、アド
レス構造体の指定された長さの範囲で表さ れる (名前中のヌルバイトには特別な意味はな
い)。この名前はファイルシステムの パス名とは何の関係もない。 getsockname(2),
getpeername(2), accept(2) が抽象ソケットのアドレスを返す際には、返される addrlen は
sizeof(sa_family_t) より大きく (つまり 2 より大きく)、ソケットの名前は sun_path の最初
の (addrlen - sizeof(sa_family_t)) バイトに格納される。 ソケットの抽象名前空間は Linux
による拡張であり、移植性はない。
ソケットオプション
歴史的な理由により、これらのオプションは たとえ AF_UNIX 固有のオプションであっても
SOL_SOCKET 型で指定する。 ソケットファミリーとして SOL_SOCKET を指定すると、 setsockopt(2)
でオプションが設定でき、 getsockopt(2) で取得ができる。
SO_PASSCRED
送信プロセスの補助メッセージで信任状を受信できるようにする。このオプションが セット
されていて、まだソケットが接続されていないと、抽象名前空間に他と重なら ない名前が自
動的に生成される。ブール整数値のフラグを取る。
自動バインド (autobind) 機能
bind(2) 呼び出しで sizeof(sa_family_t) として addrlen を指定するか、 アドレスに明示的にバ
インドされていないソケットに対して SO_PASSCRED ソケットオプションが指定されていた場合、 そ
のソケットは抽象アドレスに自動的にバインドされる。 このアドレスは、1 個のヌルバイトの後
に、文字集合 [0-9a-f] のバイトが 5 個続く形式である。したがって、自動的にバインドされるア
ドレス数には 2^20 個という上限が存在する。 (Linux 2.1.15 以降で、自動バインド機能が追加さ
れたときには、 8 バイトが使われており、自動バインドアドレス数の上限は 2^32 であった。
Linux 2.3.15 で 5 バイトに変更された。)
ソケット API
この節では、Linux の UNIX ドメインソケットでの、ドメイン固有の詳細仕様と ソケット API でサ
ポートされていない機能について説明する。
UNIX ドメインソケットでは、帯域外データ (out-of-band data) の 送信 (send(2) と recv(2) の
MSG_OOB フラグ) はサポートされていない。
send(2) MSG_MORE フラグは UNIX ドメインソケットではサポートされていない。
recv(2) の flags 引き数での MSG_TRUNC の使用は UNIX ドメイン ソケットではサポートされてい
ない。
SO_SNDBUF ソケットオプションは UNIX ドメインソケットで効果を持つが、 SO_RCVBUF は効果がな
い。 データグラム・ソケットでは、 SO_SNDBUF の値が 出力データグラムの上限サイズとなる。 実
際の上限値は、 SO_SNDBUF オプション として設定された値の 2倍 (socket(7) 参照) からオーバ
ヘッドとして使用される 32 バイトを引いた値となる。
補助メッセージ
補助データを送受するには、 sendmsg(2) や recvmsg(2) を使用する。 歴史的な理由により、以
下に示す補助メッセージの型は たとえ AF_UNIX 固有のものであっても SOL_SOCKET 型で指定する。
これらを送るには、構造体 cmsghdr の cmsg_level フィールドに SOL_SOCKET をセットし、
cmsg_type フィールドにタイプをセットする。 詳細は cmsg(3) を見よ。
SCM_RIGHTS
他のプロセスでオープンされたファイルディスクリプタのセットを送受信する。 データ部分
にファイルディスクリプタの整数配列が入っている。 渡されたファイルディスクリプタ
は、あたかも dup(2) で生成されたかのように振る舞う。
SCM_CREDENTIALS
UNIX 信任状を送受信する。これは認証に用いることができる。 信任状は struct ucred の
補助メッセージとして渡される。 この構造体は <sys/socket.h> で以下のように定義されて
いる。
struct ucred {
pid_t pid; /* process ID of the sending process */
uid_t uid; /* user ID of the sending process */
gid_t gid; /* group ID of the sending process */
};
glibc 2.8 以降では、この構造体の定義を得るためには (どのヘッダファイルをインクルー
ドするよりも前に) 機能検査マクロ _GNU_SOURCE を定義しなければならない。
送信側が指定した信任状は、カーネルがチェックする。 実効ユーザー ID が 0 のプロセス
には、 自分自身以外の値を指定する事が許される。 送信側は以下の 3 つを指定しなければ
ならない。 1) 自分自身のプロセス ID (CAP_SYS_ADMIN 権限を持っていない場合)、 2) 自
分自身のユーザー ID あるいは実効ユーザー ID か保存 set-user-ID (CAP_SETUID 権限を
持っていない場合)、 3) 自分自身のグループ ID あるいは実行グループ ID か保存
set-group-ID (CAP_SETGID を持っていない場合)。 struct ucred メッセージを受信するた
めには、ソケットに対し SO_PASSCRED オプションを有効にしなくてはならない。
ioctl
以下の ioctl(2) 呼び出しは value に情報を入れて返す。 正しい書式は以下の通り。
int value;
error = ioctl(unix_socket, ioctl_type, &value);
ioctl_type には以下を指定できる:
SIOCINQ
受信バッファのキューにある、まだ読んでいないデータの量を返す。ソケットは LISTEN 状
態にあってはならず、さもないとエラー (EINVAL) が返る。 SIOCINQ は <linux/sockios.h>
で定義されている。 代わりに、<sys/ioctl.h> で定義されている、同義語の FIONREAD を使
うこともできる。
エラー
EADDRINUSE
指定したローカルアドレスが既に使用されているか、ファイルシステムの ソケットオブジェ
クトが既に存在している。
ECONNREFUSED
connect(2) により指定されたリモートアドレスが接続待ちソケットではなかった。 ター
ゲットアドレスがソケットではない場合にもこのエラーが発生する。
ECONNRESET
リモートソケットが予期しないかたちでクローズされた。
EFAULT ユーザーメモリアドレスが不正。
EINVAL 渡した引数が不正。よくある原因としては、渡したアドレスの sun_type フィール ドに
AF_UNIX が指定されていなかった、行おうとした操作に対してソケットが有 効な状態ではな
かった、など。
EISCONN
既に接続されているソケットに対して connect(2) が呼ばれた。または、指定したターゲッ
トアドレスが 既に接続済みのソケットだった。
ENOENT connect(2) に指定されたリモートアドレスのパス名が存在しなかった。
ENOMEM メモリが足りない。
ENOTCONN
ソケット操作にターゲットアドレスが必要だが、 このソケットは接続されていない。
EOPNOTSUPP
ストリーム指向でないソケットに対してストリーム操作が呼び出された。 または帯域外デー
タオプションを用いようとした。
EPERM 送信者が struct ucred に不正な信任状を渡した。
EPIPE リモートソケットがストリームソケット上でクローズされた。 可能な場合は SIGPIPE も同
時に送られる。これを避けるには MSG_NOSIGNAL フラグを sendmsg(2) や recvmsg(2) に
渡す。
EPROTONOSUPPORT
渡されたプロトコルが AF_UNIX でない。
EPROTOTYPE
リモートソケットとローカルソケットのタイプが一致していなかった (SOCK_DGRAM と
SOCK_STREAM)。
ESOCKTNOSUPPORT
未知のソケットタイプ。
他にも汎用のソケット層でエラーが起こったり、 ファイルシステム上にソケットオブジェクトを作
ろうとした場合に ファイルシステムのエラーが起こることがある。 それぞれの詳細は適切な man
ページを参照すること。
バージョン
SCM_CREDENTIALS と抽象名前空間は、Linux 2.2 で導入された。 移植性が必要なプログラムでは使
うべきではない。 (BSD 由来のシステムの中にも信任状の送受信をサポートしているものがあるが、
その実装の詳細はシステムによって異なる)
注意
Linux の実装では、 ファイルシステム上から見えるソケットは、 それらが置かれているディレクト
リのパーミッションに従う。 ソケットの所有者、 グループ、 パーミッションは変更できる。 新し
いソケットを作るとき、 作ろうとするディレクトリに対して プロセスが書き込みと検索 (実行) 権
限を持っていなければ、 作成に失敗する。 ソケットオブジェクトに接続するには、 read/write 権
限が必要である。 この動作は、 多くの BSD 由来のシステムとは異なっている (BSD では UNIX ド
メインソケットに対してはパーミッションを無視する)。 移植性の必要なプログラムでは、セキュリ
ティをこの仕様に依存してはならない。
ファイル名を指定してソケットにバインドすると、ファイルシステムにソケットが 生成される。こ
れは必要なくなったときに呼びだしたユーザーが削除しなければ ならない (unlink(2) を用いる)。
UNIX で通常使われる「背後で閉じる方式」 が適用される。ソケットはいつでも unlink することが
でき、最後の参照が クローズされたときにファイルシステムから削除される。
SOCK_STREAM 上でファイルディスクリプタや信任状を渡すためには、同じ sendmsg(2) や
recvmsg(2) コールで補助データ以外のデータを少なくとも 1 バイト送信/受信する必要がある。
UNIX ドメインのストリーム・ソケットでは、 帯域外データの概念はサポートされない。
例
bind(2) 参照。
SCM_RIGHTS の使用例については cmsg(3) を参照。
関連項目
recvmsg(2), sendmsg(2), socket(2), socketpair(2), cmsg(3), capabilities(7),
credentials(7), socket(7)
この文書について
この man ページは Linux man-pages プロジェクトのリリース 3.65 の一部 である。プロジェクト
の説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。