src/man7/unix.7

   1 .\" 本man页版权所有(C) 1999 Andi Kleen <ak@muc.de>.
   2 .TH UNIX  7 "1999年5月7日" "Linux 手册页" "Linux程序员手册"
   3
   4 .SH NAME(名称）
   5 unix, PF_UNIX, AF_UNIX, PF_LOCAL, AF_LOCAL \- 用于本地内部进程通讯的套接字。
   6 .SH SYNOPSIS(总览)
   7 .B #include <sys/socket.h>
   8 .br
   9 .B #include <sys/un.h>
  10
  11 .IB unix_socket " = socket(PF_UNIX, type, 0);"
  12 .br
  13 .IB error " = socketpair(PF_UNIX, type, 0, int *" sv ");"
  14
  15 .SH DESCRIPTION(描述)
  16 .B PF_UNIX
  17 (也称作
  18 .B PF_LOCAL )
  19 套接字族用来在同一机器上的提供有效的进程间通讯.Unix 套接字可以是匿名的(由
  20 .BR socketpair (2)
  21 创建), 也可以与套接字类型文件相关联.
  22 Linux 还支持一种抽象名字空间, 它是独立于文件系统的.
  23
  24 有效的类型有:
  25 .B SOCK_STREAM
  26 用于面向流的套接字,
  27 .B SOCK_DGRAM
  28 用于面向数据报的套接字,其可以保存消息界限.
  29 Unix 套接字总是可靠的,而且不会重组数据报.
  30
  31 Unix 套接字支持把文件描述符或者进程的信用证明作为数据报的辅助数据
  32 传递给其它进程．
  33
  34 .SH ADDRESS FORMAT(地址格式)
  35 unix 地址定义为文件系统中的一个文件名
  36 或者抽象名字空间中的一个单独的字符串.
  37 由
  38 .BR socketpair (2)
  39 创建的套接字是匿名的.对于非匿名的套接字,目标地址可使用
  40 .BR connect (2)
  41 设置.
  42 本地地址可使用
  43 .BR bind (2)
  44 设置.
  45 当套接字连接上而且它没有一个本地地址时,
  46 会自动在抽象名字空间中生成一个唯一的地址.
  47
  48 .RS
  49 .nf
  50 #define UNIX_PATH_MAX   108
  51
  52 .ta 4n 17n 42n
  53 struct sockaddr_un {
  54 sa_family_t     sun_family;     /* AF_UNIX */
  55 char    sun_path[UNIX_PATH_MAX];        /* 路径名 */
  56 };
  57 .fi
  58 .RE
  59
  60 .B sun_family
  61 总是包含
  62 .BR AF_UNIX .
  63 .B sun_path
  64 包含空零结尾的套接字在文件系统中的路径名.
  65 如果
  66 .B sun_path
  67 以空零字节开头,它指向由 Unix 协议模块维护的抽象名字空间.
  68 该套接字在此名字空间中的地址由
  69 .BR sun_path
  70 中的剩余字节给定.
  71 注意抽象名字空间的名字都不是空零终止的.
  72
  73 .SH SOCKET OPTIONS(套接字选项)
  74 由于历史原因, 这些套接字选项通过 SOL_SOCKET 类型确定,
  75 即使它们是 PF_UNIX 指定的.
  76 它们可以由
  77 .BR setsockopt (2)
  78 设置.
  79 通过指定 SOL_SOCKET 作为套接字族
  80 用
  81 .BR getsockopt (2)
  82 来读取.
  83
  84 .B SO_PASSCRED
  85 允许接收进程辅助信息发送的信用证明.
  86 当设置了该选项且套接字尚未连接时,
  87 则会自动生成一个抽象名字空间的唯一名字.
  88 值为一个整数布尔标识.
  89
  90 .SH ANCILLARY MESSAGES(辅助信息)
  91 由于历史原因,这些辅助信息类型通过 SOL_SOCKET 类型确定,
  92 即使它们是 PF_UNIX 指定的.
  93 要发送它们, 可设置结构
  94 .B cmsghdr
  95 的
  96 .B cmsg_level
  97 字段为 SOL_SOCKET, 并设置
  98 .B cmsg_type
  99 字段为其类型. 要获得更多信息, 请参看
 100 .BR cmsg (3).
 101
 102 .TP
 103 .B SCM_RIGHTS
 104 为其他进程发送或接收一套打开文件描述符.
 105 其数据部分包含一个文件描述符的整型数组.
 106 已传文件描述符的效果就如它们已由
 107 .BR dup (2)
 108 创建过一样.
 109
 110 .TP
 111 .B SCM_CREDENTIALS
 112 发送或者接收 unix 信用证明.
 113 可用作认证.信用证明传送以
 114 .B struct ucred
 115 辅助信息的形式传送．
 116
 117 .RS
 118 .nf
 119 .ta 4n 11n 17n
 120 struct ucred {
 121 pid_t   pid;     /* 发送进程的进程标识 */
 122 uid_t   uid;     /* 发送进程的用户标识 */
 123 gid_t   gid;     /* 发送进程的组标识 */
 124 };
 125 .fi
 126 .RE
 127
 128 发送者确定的信用证明由内核检查.
 129 一个带有有效用户标识 0 的进程允许指定不与其自身值相
 130 匹配的值.发送者必须确定其自身的进程标识(除非它带有
 131 .BR CAP_SYS_ADMIN ),
 132 其用户标识,有效用户标识或者设置用户标识(除非它带有
 133 .BR CAP_SETUID ),
 134 以及其组标识,有效组标识或者设置组标识(除非它带有
 135 .BR CAP_SETGID ).
 136 为了接收一条
 137 .B struct ucred
 138 消息,必须在套接字上激活
 139 .B SO_PASSCRED
 140 选项.
 141
 142 .SH VERSIONS(版本)
 143 .B SCM_CREDENTIALS
 144 和抽象名字空间是在 Linux 2.2 中引入的,不应该在要求可移植的程序中使用.
 145
 146 .SH NOTES(注意)
 147 在 Linux 实现中,
 148 在文件系统中可见的套接字拥有它们所在目录的权限许可.
 149 它们的所有者,组和权限可以作修改.
 150 如果进程不拥有对创建的套接字所在目录的写和搜索(执行)权限,
 151 则创建一个新的套接字会失败.
 152 这种执行方式与许多由 BSD 发展而来的系统不同,
 153 那些系统会忽略 Unix 套接字所需的权限.
 154 可移植的程序不应把这项功能用于安全方面．
 155
 156 绑定文件名到套接字会在文件系统中创建一个套接字,
 157 这个套接字在它不再需要时必须由调用者
 158 删除(使用
 159 .BR unlink (2)).
 160 通用的 Unix 相关语义可适用;
 161 套接字可在任何时候删除, 而且当最后一个引用关闭时,
 162 最终会从文件系统中删除.
 163
 164 要传递文件描述符或者信用证明, 你需要发送/读取至少一个字节.
 165
 166 .SH ERRORS(错误)
 167 .TP
 168 .B ENOMEM
 169 内存溢出.
 170
 171 .TP
 172 .B ECONNREFUSED
 173 .BR connect (2)
 174 调用了一个未在监听的套接字对象.
 175 这可能发生在远程套接字不存在或者文件名不是套接字的时候.
 176
 177 .TP
 178 .B EINVAL
 179 传递了无效参数.
 180 通常的产生原因是已传地址的 sun_type 字段的 AF_UNIX 设置丢失,
 181 或者套接字对应用的操作处于无效状态.
 182
 183 .TP
 184 .B EOPNOTSUPP
 185 在非面向流的套接字上调用了流操作,或者试图使用出界的数据选项.
 186
 187 .TP
 188 .B EPROTONOSUPPORT
 189 传递的协议是非 PF_UNIX 的.
 190
 191 .TP
 192 .B ESOCKTNOSUPPORT
 193 未知的套接字类型.
 194
 195 .TP
 196 .B EPROTOTYPE
 197 远程套接字与本地套接字类型不匹配 (SOCK_DGRAM 对 SOCK_STREAM).
 198
 199 .TP
 200 .B EADDRINUSE
 201 选择的本地地址已经占用,或者文件系统套接字对象已经存在.
 202
 203 .TP
 204 .B EISCONN
 205 在一个已经连接的套接字上调用
 206 .BR connect (2)
 207 或者指定的目标地址在一个已连接的套接字上.
 208
 209 .TP
 210 .B ENOTCONN
 211 套接字操作需要一个目的地址,但是套接字尚未连接.
 212
 213 .TP
 214 .B ECONNRESET
 215 远程套接字意外关闭.
 216 .TP
 217 .B EPIPE
 218 远程套接字在一个流套接字上关闭了.如果激活,会同时发送一个
 219 .B SIGPIPE
 220 标识.这可以通过传递
 221 .B MSG_NOSIGNAL
 222 标识给
 223 .BR sendmsg (2)
 224 或者
 225 .BR recvmsg (2)
 226 来避免.
 227 .TP
 228 .B EFAULT
 229 用户内存地址无效.
 230 .TP
 231 .B EPERM
 232 发送者在
 233 .BR "struct ucred"
 234 中传递无效的信用证明.
 235 .PP
 236 当生成一个文件系统套接字对象时,
 237 可能会由通用套接层或者文件系统产生其它错误.
 238 要获得更多信息,可参见合适的手册页.
 239 .SH SEE ALSO(另见)
 240 .BR recvmsg (2),
 241 .BR sendmsg (2),
 242 .BR socket (2),
 243 .BR socket (2),
 244 .BR socketpair (2),
 245 .BR cmsg (3),
 246 .BR socket (7)
 247 .SH CREDITS(尾注)
 248 本man页作者Andi Kleen.
 249
 250 .SH "[中文版维护人]"
 251 .B riser <boomer@ccidnet.com>
 252 .SH "[中文版最新更新]"
 253 .BR 2001/07/19
 254 .SH "《中国linux论坛man手册页翻译计划》:"
 255 .BI http://cmpp.linuxforum.net