UNIX 7
目录
- NAME(名称） unix, PF_UNIX, AF_UNIX, PF_LOCAL, AF_LOCAL
- SYNOPSIS(总览)
.B #include
.br .B #include .IB unix_socket - DESCRIPTION(描述) .B PF_UNIX (也称作 .B PF_LOCAL ) 套接字族用来在同一机器上的提供有效的进程间通讯.Unix 套接字可以是匿名的(由 .BR socketpair (2) 创建), 也可以与套接字类型文件相关联. Linux 还支持一种抽象名字空间, 它是独立于文件系统的. 有效的类型有: .B SOCK_STREAM 用于面向流的套接字, .B SOCK_DGRAM 用于面向数据报的套接字,其可以保存消息界限. Unix 套接字总是可靠的,而且不会重组数据报. Unix 套接字支持把文件描述符或者进程的信用证明作为数据报的辅助数据 传递给其它进程． .SH ADDRESS FORMAT(地址格式) unix 地址定义为文件系统中的一个文件名 或者抽象名字空间中的一个单独的字符串. 由 .BR socketpair (2) 创建的套接字是匿名的.对于非匿名的套接字,目标地址可使用 .BR connect (2) 设置. 本地地址可使用 .BR bind (2) 设置. 当套接字连接上而且它没有一个本地地址时, 会自动在抽象名字空间中生成一个唯一的地址. .RS .nf #define UNIX_PATH_MAX 108 .ta 4n 17n 42n struct sockaddr_un { sa_family_t sun_family; /* AF_UNIX */ char sun_path[UNIX_PATH_MAX]; /* 路径名 */ }; .fi .RE .B sun_family 总是包含 .BR AF_UNIX . .B sun_path 包含空零结尾的套接字在文件系统中的路径名. 如果 .B sun_path 以空零字节开头,它指向由 Unix 协议模块维护的抽象名字空间. 该套接字在此名字空间中的地址由 .BR sun_path 中的剩余字节给定. 注意抽象名字空间的名字都不是空零终止的. .SH SOCKET OPTIONS(套接字选项) 由于历史原因, 这些套接字选项通过 SOL_SOCKET 类型确定, 即使它们是 PF_UNIX 指定的. 它们可以由 .BR setsockopt (2) 设置. 通过指定 SOL_SOCKET 作为套接字族 用 .BR getsockopt (2) 来读取. .B SO_PASSCRED 允许接收进程辅助信息发送的信用证明. 当设置了该选项且套接字尚未连接时, 则会自动生成一个抽象名字空间的唯一名字. 值为一个整数布尔标识. .SH ANCILLARY MESSAGES(辅助信息) 由于历史原因,这些辅助信息类型通过 SOL_SOCKET 类型确定, 即使它们是 PF_UNIX 指定的. 要发送它们, 可设置结构 .B cmsghdr 的 .B cmsg_level 字段为 SOL_SOCKET, 并设置 .B cmsg_type 字段为其类型. 要获得更多信息, 请参看 .BR cmsg (3). .TP .B SCM_RIGHTS 为其他进程发送或接收一套打开文件描述符. 其数据部分包含一个文件描述符的整型数组. 已传文件描述符的效果就如它们已由 .BR dup (2) 创建过一样. .TP .B SCM_CREDENTIALS 发送或者接收 unix 信用证明. 可用作认证.信用证明传送以 .B struct ucred 辅助信息的形式传送． .RS .nf .ta 4n 11n 17n struct ucred { pid_t pid; /* 发送进程的进程标识 */ uid_t uid; /* 发送进程的用户标识 */ gid_t gid; /* 发送进程的组标识 */ }; .fi .RE 发送者确定的信用证明由内核检查. 一个带有有效用户标识 0 的进程允许指定不与其自身值相 匹配的值.发送者必须确定其自身的进程标识(除非它带有 .BR CAP_SYS_ADMIN ), 其用户标识,有效用户标识或者设置用户标识(除非它带有 .BR CAP_SETUID ), 以及其组标识,有效组标识或者设置组标识(除非它带有 .BR CAP_SETGID ). 为了接收一条 .B struct ucred 消息,必须在套接字上激活 .B SO_PASSCRED 选项. .SH VERSIONS(版本) .B SCM_CREDENTIALS 和抽象名字空间是在 Linux 2.2 中引入的,不应该在要求可移植的程序中使用. .SH NOTES(注意) 在 Linux 实现中, 在文件系统中可见的套接字拥有它们所在目录的权限许可. 它们的所有者,组和权限可以作修改. 如果进程不拥有对创建的套接字所在目录的写和搜索(执行)权限, 则创建一个新的套接字会失败. 这种执行方式与许多由 BSD 发展而来的系统不同, 那些系统会忽略 Unix 套接字所需的权限. 可移植的程序不应把这项功能用于安全方面． 绑定文件名到套接字会在文件系统中创建一个套接字, 这个套接字在它不再需要时必须由调用者 删除(使用 .BR unlink (2)). 通用的 Unix 相关语义可适用; 套接字可在任何时候删除, 而且当最后一个引用关闭时, 最终会从文件系统中删除. 要传递文件描述符或者信用证明, 你需要发送/读取至少一个字节. .SH ERRORS(错误) .TP .B ENOMEM 内存溢出. .TP .B ECONNREFUSED .BR connect (2) 调用了一个未在监听的套接字对象. 这可能发生在远程套接字不存在或者文件名不是套接字的时候. .TP .B EINVAL 传递了无效参数. 通常的产生原因是已传地址的 sun_type 字段的 AF_UNIX 设置丢失, 或者套接字对应用的操作处于无效状态. .TP .B EOPNOTSUPP 在非面向流的套接字上调用了流操作,或者试图使用出界的数据选项. .TP .B EPROTONOSUPPORT 传递的协议是非 PF_UNIX 的. .TP .B ESOCKTNOSUPPORT 未知的套接字类型. .TP .B EPROTOTYPE 远程套接字与本地套接字类型不匹配 (SOCK_DGRAM 对 SOCK_STREAM). .TP .B EADDRINUSE 选择的本地地址已经占用,或者文件系统套接字对象已经存在. .TP .B EISCONN 在一个已经连接的套接字上调用 .BR connect (2) 或者指定的目标地址在一个已连接的套接字上. .TP .B ENOTCONN 套接字操作需要一个目的地址,但是套接字尚未连接. .TP .B ECONNRESET 远程套接字意外关闭. .TP .B EPIPE 远程套接字在一个流套接字上关闭了.如果激活,会同时发送一个 .B SIGPIPE 标识.这可以通过传递 .B MSG_NOSIGNAL 标识给 .BR sendmsg (2) 或者 .BR recvmsg (2) 来避免. .TP .B EFAULT 用户内存地址无效. .TP .B EPERM 发送者在 .BR
- SEE ALSO(另见) .BR recvmsg (2), .BR sendmsg (2), .BR socket (2), .BR socket (2), .BR socketpair (2), .BR cmsg (3), .BR socket (7) .SH CREDITS(尾注) 本man页作者Andi Kleen. .SH
- [中文版最新更新]
- 《中国linux论坛man手册页翻译计划》:
- 跋
UNIX
NAME(å称ï¼SYNOPSIS(æ»è§)
DESCRIPTION(æè¿°)
ADDRESS FORMAT(å°åæ ¼å¼)
SOCKET OPTIONS(å¥æ¥åé项)
ANCILLARY MESSAGES(è¾å©ä¿¡æ¯)
VERSIONS(çæ¬)
NOTES(注æ)
ERRORS(é误)
SEE ALSO(å¦è§)
CREDITS(尾注)
[ä¸æçç»´æ¤äºº]
[ä¸æçææ°æ´æ°]
ãä¸å½linux论åmanæå页翻è¯è®¡åã:
è·
NAME(å称ï¼
unix, PF_UNIX, AF_UNIX, PF_LOCAL, AF_LOCAL - ç¨äºæ¬å°åé¨è¿ç¨é讯çå¥æ¥åã
SYNOPSIS(æ»è§)
#include
<sys/socket.h>
#include <sys/un.h>
unix_socket
= socket(PF_UNIX, type, 0);
error = socketpair(PF_UNIX, type, 0, int
*sv);
DESCRIPTION(æè¿°)
PF_UNIX (ä¹ç§°ä½ PF_LOCAL ) å¥æ¥åæç¨æ¥å¨åä¸æºå¨ä¸çæä¾ææçè¿ç¨é´é讯.Unix å¥æ¥åå¯ä»¥æ¯å¿åç(ç± socketpair(2) å建), ä¹å¯ä»¥ä¸å¥æ¥åç±»åæ件ç¸å³è. Linux è¿æ¯æä¸ç§æ½è±¡åå空é´, å®æ¯ç¬ç«äºæ件系ç»ç.
ææçç±»åæ: SOCK_STREAM ç¨äºé¢åæµçå¥æ¥å, SOCK_DGRAM ç¨äºé¢åæ°æ®æ¥çå¥æ¥å- ,å¶å¯ä»¥ä¿åæ¶æ¯çé. Unix å¥æ¥åæ»æ¯å¯é ç,èä¸ä¸ä¼éç»æ°æ®æ¥.
Unix å¥æ¥åæ¯æææ件æ述符æèè¿ç¨çä¿¡ç¨è¯æä½ä¸ºæ°æ®æ¥çè¾å©æ°æ® ä¼ éç»å¶å®è¿ç¨ï¼
ADDRESS FORMAT(å°åæ ¼å¼)
unix å°åå®ä¹ä¸ºæ件系ç»ä¸çä¸ä¸ªæ件å æèæ½è±¡åå空é´ä¸çä¸ä¸ªåç¬çå- 符串. ç± socketpair(2) å建çå¥æ¥åæ¯å¿åç.对äºéå¿åçå¥æ¥å- ,ç®æ å°åå¯ä½¿ç¨ connect(2) 设置. æ¬å°å°åå¯ä½¿ç¨ bind(2) 设置. å½å¥æ¥åè¿æ¥ä¸èä¸å®æ²¡æä¸ä¸ªæ¬å°å°åæ¶, ä¼èªå¨å¨æ½è±¡åå空é´ä¸- çæä¸ä¸ªå¯ä¸çå°å.
#define UNIX_PATH_MAX 108
struct
sockaddr_un {
sa_family_t sun_family; /* AF_UNIX */
char sun_path[UNIX_PATH_MAX]; /*
è·¯å¾å */
};
sun_family æ»æ¯åå« AF_UNIX. sun_path åå«ç©ºé¶ç»å°¾çå¥æ¥åå¨æ件系ç»ä¸- çè·¯å¾å. å¦æ sun_path 以空é¶åèå¼å¤´,å®æåç± Unix å议模åç»´æ¤çæ½è±¡åå空é´. 该å¥æ¥åå¨æ¤åå空é´ä¸çå°åç± sun_path ä¸- çå©ä½åèç»å®. 注ææ½è±¡åå空é´çååé½ä¸æ¯ç©ºé¶ç»æ¢ç.
SOCKET OPTIONS(å¥æ¥åé项)
ç±äºåå²åå , è¿äºå¥æ¥åé项éè¿ SOL_SOCKET ç±»åç¡®å®, å³ä½¿å®ä»¬æ¯ PF_UNIX æå®ç. å®ä»¬å¯ä»¥ç± setsockopt(2) 设置. éè¿æå® SOL_SOCKET ä½ä¸ºå¥æ¥åæ ç¨ getsockopt(2) æ¥è¯»å.
SO_PASSCRED å许æ¥æ¶è¿ç¨è¾å©ä¿¡æ¯åéçä¿¡ç¨è¯æ. å½è®¾ç½®äºè¯¥é项ä¸å¥æ¥åå°æªè¿æ¥æ¶, åä¼èªå¨çæä¸ä¸ªæ½è±¡åå空é´çå¯ä¸åå. å¼ä¸ºä¸ä¸ªæ´æ°å¸å°æ è¯.
ANCILLARY MESSAGES(è¾å©ä¿¡æ¯)
ç±äºåå²åå ,è¿äºè¾å©ä¿¡æ¯ç±»åéè¿
SOL_SOCKET
ç±»åç¡®å®,
å³ä½¿å®ä»¬æ¯
PF_UNIX æå®ç.
è¦åéå®ä»¬,
å¯è®¾ç½®ç»æ
cmsghdr ç cmsg_level
å段为 SOL_SOCKET,
并设置
cmsg_type
å段为å¶ç±»å.
è¦è·å¾æ´å¤ä¿¡æ¯,
请åç cmsg(3).
SCM_RIGHTS
为å¶ä»è¿ç¨åéææ¥æ¶ä¸å¥æå¼æ件æ述符. å¶æ°æ®é¨ååå«ä¸ä¸ªæ件æ述符çæ´åæ°ç». å·²ä¼ æ件æ述符çææå°±å¦å®ä»¬å·²ç± dup(2) å建è¿ä¸æ ·.
SCM_CREDENTIALS
åéæèæ¥æ¶ unix ä¿¡ç¨è¯æ. å¯ç¨ä½è®¤è¯.ä¿¡ç¨è¯æä¼ é以 struct ucred è¾å©ä¿¡æ¯çå½¢å¼ä¼ éï¼
struct ucred {
pid_t pid; /*
åéè¿ç¨çè¿ç¨æ è¯
*/
uid_t uid; /*
åéè¿ç¨çç¨æ·æ è¯
*/
gid_t gid; /*
åéè¿ç¨çç»æ è¯
*/
};
åéèç¡®å®çä¿¡ç¨è¯æç±åæ ¸æ£æ¥. ä¸ä¸ªå¸¦æææç¨æ·æ è¯ 0 çè¿ç¨å许æå®ä¸ä¸å¶èªèº«å¼ç¸ å¹éçå¼.åéèå¿é¡»ç¡®å®å¶èªèº«çè¿ç¨æ è¯(é¤éå®å¸¦æ CAP_SYS_ADMIN), å¶ç¨æ·æ è¯,ææç¨æ·æ è¯æè设置ç¨æ·æ è¯(é¤éå®å¸¦æ CAP_SETUID), 以åå¶ç»æ è¯,ææç»æ è¯æè设置ç»æ è¯(é¤éå®å¸¦æ CAP_SETGID). 为äºæ¥æ¶ä¸æ¡ struct ucred æ¶æ¯,å¿é¡»å¨å¥æ¥åä¸æ¿æ´» SO_PASSCRED é项.
VERSIONS(çæ¬)
SCM_CREDENTIALS åæ½è±¡åå空é´æ¯å¨ Linux 2.2 ä¸- å¼å¥ç,ä¸åºè¯¥å¨è¦æ±å¯ç§»æ¤çç¨åºä¸ä½¿ç¨.
NOTES(注æ)
å¨ Linux å®ç°ä¸, å¨æ件系ç»ä¸å¯è§çå¥æ¥åæ¥æå®ä»¬æå¨ç®å½çæé许å¯. å®ä»¬çææè,ç»åæéå¯ä»¥ä½ä¿®æ¹. å¦æè¿ç¨ä¸æ¥æ对å建çå¥æ¥å- æå¨ç®å½çååæç´¢(æ§è¡)æé, åå建ä¸ä¸ªæ°çå¥æ¥åä¼å¤±è´¥. è¿ç§æ§è¡æ¹å¼ä¸è®¸å¤ç± BSD åå±èæ¥çç³»ç»ä¸å, é£äºç³»ç»ä¼å¿½ç¥ Unix å¥æ¥å- æéçæé. å¯ç§»æ¤çç¨åºä¸åºæè¿é¡¹åè½ç¨äºå®å¨æ¹é¢ï¼
ç»å®æ件åå°å¥æ¥åä¼å¨æ件系ç»ä¸å建ä¸ä¸ªå¥æ¥å, è¿ä¸ªå¥æ¥å- å¨å®ä¸åéè¦æ¶å¿é¡»ç±è°ç¨è å é¤(ä½¿ç¨ unlink(2)). éç¨ç Unix ç¸å³è¯- ä¹å¯éç¨; å¥æ¥åå¯å¨ä»»ä½æ¶åå é¤, èä¸å½æåä¸ä¸ªå¼ç¨å³éæ¶, æç»ä¼ä»æ件系ç»ä¸å é¤.
è¦ä¼ éæ件æ述符æèä¿¡ç¨è¯æ, ä½ éè¦åé/读åè³å°ä¸ä¸ªåè.
ERRORS(é误)
|
ENOMEM |
åå溢åº. |
ECONNREFUSED
connect(2) è°ç¨äºä¸ä¸ªæªå¨çå¬çå¥æ¥å对象. è¿å¯è½åçå¨è¿ç¨å¥æ¥å- ä¸åå¨æèæ件åä¸æ¯å¥æ¥åçæ¶å.
|
EINVAL |
ä¼ éäºæ æåæ°. é常ç产çåå æ¯å·²ä¼ å°åç sun_type å段ç AF_UNIX 设置丢失, æèå¥æ¥å对åºç¨çæä½å¤äºæ æç¶æ. |
EOPNOTSUPP
å¨éé¢åæµçå¥æ¥åä¸è°ç¨äºæµæä½,æèè¯å¾ä½¿ç¨åºççæ°æ®é项.
EPROTONOSUPPORT
ä¼ éçåè®®æ¯é PF_UNIX ç.
ESOCKTNOSUPPORT
æªç¥çå¥æ¥åç±»å.
EPROTOTYPE
è¿ç¨å¥æ¥åä¸æ¬å°å¥æ¥åç±»åä¸å¹é (SOCK_DGRAM 对 SOCK_STREAM).
EADDRINUSE
éæ©çæ¬å°å°åå·²ç»å ç¨,æèæ件系ç»å¥æ¥å对象已ç»åå¨.
EISCONN
å¨ä¸ä¸ªå·²ç»è¿æ¥çå¥æ¥åä¸è°ç¨ connect(2) æèæå®çç®æ å°åå¨ä¸ä¸ªå·²è¿æ¥çå¥æ¥åä¸.
ENOTCONN
å¥æ¥åæä½éè¦ä¸ä¸ªç®çå°å,ä½æ¯å¥æ¥åå°æªè¿æ¥.
ECONNRESET
è¿ç¨å¥æ¥åæå¤å³é.
|
EPIPE |
è¿ç¨å¥æ¥åå¨ä¸ä¸ªæµå¥æ¥åä¸å³éäº.å¦ææ¿æ´»,ä¼åæ¶åéä¸ä¸ª SIGPIPE æ è¯.è¿å¯ä»¥éè¿ä¼ é MSG_NOSIGNAL æ è¯ç» sendmsg(2) æè recvmsg(2) æ¥é¿å. | ||
|
EFAULT |
ç¨æ·ååå°åæ æ. | ||
|
EPERM |
åéèå¨ struct ucred ä¸ä¼ éæ æçä¿¡ç¨è¯æ. |
å½çæä¸ä¸ªæ件系ç»å¥æ¥å对象æ¶, å¯è½ä¼ç±éç¨å¥æ¥å±æèæ件系ç»äº§çå¶å®é误. è¦è·å¾æ´å¤ä¿¡æ¯,å¯åè§åéçæå页.
SEE ALSO(å¦è§)
recvmsg(2), sendmsg(2), socket(2), socket(2), socketpair(2), cmsg(3), socket(7)
CREDITS(尾注)
æ¬man页ä½èAndi Kleen.
[ä¸æçç»´æ¤äºº]
riser <boomer@ccidnet.com>
[ä¸æçææ°æ´æ°]
2001/07/19
ãä¸å½linux论åmanæå页翻è¯è®¡åã:
http://cmpp.linuxforum.net
è·
æ¬é¡µé¢ä¸æçç±ä¸æ
man
æå页计åæä¾ã
ä¸æ man
æå页计åï¼https://github.com/man-pages-zh/manpages-zh