Man page - raw(7)
Packages contas this manual
- pts(4)
- initrd(4)
- bootparam(7)
- proc_driver(5)
- udp(7)
- proc_pid_numa_maps(5)
- standards(7)
- epoll(7)
- proc(5)
- proc_net(5)
- urandom(4)
- proc_pid_fdinfo(5)
- mailaddr(7)
- iso-8859-5(7)
- iso_8859-6(7)
- iconv(1)
- full(4)
- user-keyring(7)
- intro(5)
- ftm(7)
- shm_overview(7)
- feature_test_macros(7)
- proc_crypto(5)
- tzfile(5)
- aio(7)
- boot(7)
- proc_profile(5)
- proc_cgroups(5)
- cpuset(7)
- proc_pid_coredump_filter(5)
- proc_pid_cwd(5)
- proc_uptime(5)
- st(4)
- precedence(7)
- ddp(7)
- proc_zoneinfo(5)
- iso_8859_3(7)
- proc_pid_root(5)
- latin4(7)
- proc_tid_children(5)
- proc_pid_oom_adj(5)
- proc_mounts(5)
- iso_8859-14(7)
- ld-linux(8)
- capabilities(7)
- ptmx(4)
- mouse(4)
- sysfs(5)
- rtld-audit(7)
- proc_partitions(5)
- iso_8859_6(7)
- queue(7)
- proc_pid_pagemap(5)
- proc_pid_stack(5)
- proc_pid_mem(5)
- uri(7)
- ttytype(5)
- namespaces(7)
- proc_sys_user(5)
- latin5(7)
- procfs(5)
- charmap(5)
- proc_sys_kernel(5)
- getent(1)
- ip(7)
- iso_8859-5(7)
- queue(3)
- proc_sys_vm(5)
- random(7)
- iso-8859-10(7)
- process-keyring(7)
- protocols(5)
- system_data_types(7)
- operator(7)
- proc_pid_timerslack_ns(5)
- wtmp(5)
- iso_8859_15(7)
- cp1252(7)
- iso_8859_11(7)
- pkeys(7)
- kmem(4)
- proc_pid_clear_refs(5)
- proc_meminfo(5)
- latin8(7)
- zdump(8)
- fuse(4)
- utf-8(7)
- proc_kpagecount(5)
- futex(7)
- complex(7)
- iso_8859-13(7)
- proc_kcore(5)
- iso_8859-8(7)
- iso_8859_14(7)
- iconvconfig(8)
- network_namespaces(7)
- thread-keyring(7)
- locale(5)
- proc_pid_oom_score_adj(5)
- proc_pid_statm(5)
- signal-safety(7)
- units(7)
- re_format(7)
- proc_pid_comm(5)
- latin1(7)
- glibc(7)
- environ(7)
- iso_8859-9(7)
- tty(4)
- proc_pid_projid_map(5)
- urn(7)
- iso_8859_8(7)
- proc_loadavg(5)
- ipc_namespaces(7)
- proc_pid_syscall(5)
- proc_pid_cgroup(5)
- proc_pid_mountstats(5)
- proc_kpageflags(5)
- utmpx(5)
- termio(7)
- iso-8859-13(7)
- suffixes(7)
- iso_8859-16(7)
- intro(1)
- hostname(7)
- proc_pid_status(5)
- proc_pid_fd(5)
- proc_malloc(5)
- proc_sys_debug(5)
- proc_pid_mounts(5)
- console_codes(4)
- iso_8859_2(7)
- iso-8859-16(7)
- proc_thread-self(5)
- socket(7)
- sock_diag(7)
- null(4)
- raw(7)
- memusagestat(1)
- proc_pid_mountinfo(5)
- proc_sys_sunrpc(5)
- iso-8859-1(7)
- motd(5)
- iso_8859-7(7)
- utmp(5)
- proc_pid_auxv(5)
- latin2(7)
- intro(2)
- proc_modules(5)
- user_namespaces(7)
- iso-8859-2(7)
- proc_version(5)
- ldd(1)
- iso_8859-3(7)
- proc_diskstats(5)
- session-keyring(7)
- ascii(7)
- hosts.equiv(5)
- group(5)
- intro(4)
- proc_cmdline(5)
- resolver(5)
- time(7)
- packet(7)
- proc_kpagecgroup(5)
- hosts(5)
- proc_pid_maps(5)
- proc_tty(5)
- inotify(7)
- msr(4)
- tzselect(8)
- proc_locks(5)
- hpsa(4)
- mount_namespaces(7)
- cgroups(7)
- fanotify(7)
- latin7(7)
- intro(6)
- proc_slabinfo(5)
- proc_timer_list(5)
- proc_kallsyms(5)
- mq_overview(7)
- proc_buddyinfo(5)
- iso_8859-15(7)
- proc_pid_wchan(5)
- iso-8859-8(7)
- proc_stat(5)
- attributes(7)
- proc_bus(5)
- sln(8)
- iso_8859_4(7)
- cgroup_namespaces(7)
- symlink(7)
- fifo(7)
- proc_keys(5)
- locale(1)
- proc_devices(5)
- inode(7)
- iso_8859_13(7)
- nptl(7)
- svipc(7)
- proc_sys_proc(5)
- xattr(7)
- proc_key-users(5)
- iso_8859_10(7)
- erofs(5)
- sd(4)
- proc_ide(5)
- proc_dma(5)
- proc_pid_environ(5)
- utf8(7)
- proc_pid_seccomp(5)
- tcp(7)
- localedef(1)
- path_resolution(7)
- proc_kmsg(5)
- regex(7)
- unix(7)
- netdevice(7)
- host.conf(5)
- nss(5)
- proc_pid_io(5)
- issue(5)
- iso_8859-10(7)
- pipe(7)
- nologin(5)
- vcs(4)
- proc_mtrr(5)
- networks(5)
- resolv.conf(5)
- pldd(1)
- koi8-r(7)
- arp(7)
- ld.so(8)
- wavelan(4)
- proc_pid_uid_map(5)
- zero(4)
- iso-8859-7(7)
- memusage(1)
- iso-8859-6(7)
- latin6(7)
- user-session-keyring(7)
- armscii-8(7)
- shells(5)
- cp1251(7)
- rtnetlink(7)
- koi8-u(7)
- address_families(7)
- cpuid(4)
- core(5)
- pty(7)
- tis-620(7)
- iso_8859-1(7)
- math_error(7)
- iso_8859-4(7)
- proc_pid_autogroup(5)
- man(7)
- cciss(4)
- icmp(7)
- sprof(1)
- glob(7)
- iso-8859-9(7)
- proc_sys_dev(5)
- url(7)
- zic(8)
- sched(7)
- services(5)
- proc_pid(5)
- securetty(5)
- acct(5)
- loop(4)
- vcsa(4)
- iso_8859-2(7)
- proc_vmstat(5)
- pthreads(7)
- proc_timer_stats(5)
- uts_namespaces(7)
- elf(5)
- libc(7)
- proc_sysrq-trigger(5)
- credentials(7)
- proc_sys_net(5)
- numa(7)
- bpf-helpers(7)
- netlink(7)
- proc_pid_personality(5)
- iso_8859-11(7)
- mem(4)
- proc_apm(5)
- proc_pid_task(5)
- proc_cpuinfo(5)
- iso_8859_7(7)
- random(4)
- proc_sys_fs(5)
- proc_pid_ns(5)
- proc_filesystems(5)
- slabinfo(5)
- proc_sys_abi(5)
- latin9(7)
- proc_pid_stat(5)
- proc_execdomains(5)
- proc_swaps(5)
- keyrings(7)
- proc_ioports(5)
- iso_8859_1(7)
- hd(4)
- proc_self(5)
- landlock(7)
- proc_interrupts(5)
- port(4)
- proc_pid_cpuset(5)
- vdso(7)
- iso_8859_5(7)
- intro(7)
- mtrace(1)
- latin3(7)
- proc_sys(5)
- repertoiremap(5)
- lirc(4)
- filesystems(5)
- proc_ksyms(5)
- unicode(7)
- iso_8859_9(7)
- man-pages(7)
- pid_namespaces(7)
- proc_pid_attr(5)
- proc_sysvipc(5)
- intro(3)
- spufs(7)
- proc_config.gz(5)
- sem_overview(7)
- ldconfig(8)
- loop-control(4)
- iso-8859-4(7)
- proc_pid_timers(5)
- smartpqi(4)
- posixoptions(7)
- nsswitch.conf(5)
- proc_pid_map_files(5)
- time_namespaces(7)
- string_copying(7)
- iso-8859-11(7)
- proc_pid_gid_map(5)
- latin10(7)
- proc_pid_setgroups(5)
- ld-linux.so(8)
- ram(4)
- iso-8859-3(7)
- intro(8)
- proc_fb(5)
- vsock(7)
- termcap(5)
- fs(5)
- proc_iomem(5)
- iso-8859-15(7)
- signal(7)
- persistent-keyring(7)
- rtc(4)
- dsp56k(4)
- proc_pid_net(5)
- rpc(5)
- lp(4)
- veth(4)
- hier(7)
- kernel_lockdown(7)
- iso-8859-14(7)
- dir_colors(5)
- proc_scsi(5)
- proc_pid_cmdline(5)
- proc_fs(5)
- x25(7)
- proc_tid(5)
- proc_pid_smaps(5)
- proc_pid_limits(5)
- proc_pid_oom_score(5)
- locale(7)
- proc_pci(5)
- charsets(7)
- iso_8859_16(7)
- ipv6(7)
- tmpfs(5)
- proc_pid_exe(5)
- sysvipc(7)
- udplite(7)
- gai.conf(5)
apt-get install manpages
Available languages:
en fr pt_BR es ja ru ro zh_TW zh_CNManual
| RAW(7) | Linux 程式設計師手冊 | RAW(7) |
NAME
raw, SOCK_RAW - Linux IPv4 raw socket.
總 覽
#include <sys/socket.h>
#include <netinet/in.h>
raw_socket = socket(PF_INET, SOCK_RAW, int protocol );
描 述
Raw sockets 使得使用者端可以實現新的 IPv4 協議。 raw socket 裝置接收或傳送不含連結層報頭的原始資料包。 只有啟用介面選項 IP_HDRINCL 時 IPv4 層才會在傳輸包中 新增 IP 報頭。而且當啟用時,包中必須含有 IP 報頭。包中含 有 IP 報頭才能被接收。
只有 user id 為 0 或具有 CAP_NET_RAW 能力才能開啟 raw sockets.
所有匹配為此 raw socket 宣告的協議號的包或錯誤都將被傳 送到該 socket.要察看許可的協議列表, 請參考 RFC1700 給出的代號和 getprotobyname (3).
IPPROTO_RAW 意味著 IP_HDRINCL 處於啟用狀態,也意味著接收 所有 IP 協議. 但是不允許傳送。
| IP_HDRINCL 會在傳送時修改 IP 報頭。 | |
| IP Checksum | 總是寫入。 |
| Source Address | 為 0 時寫入。 |
| Packet Id | 為 0 時寫入。 |
| Total Length | 總是寫入。 |
如果指定了 IP_HDRINCL 且 IP 報頭含有的目的地址不是 0,那麼 該 socket 的目的地址用於路由該包。 如果指定了 MSG_DONTROUTE 則目的地址 應指向某個本地介面。否則會進行路有表查詢,但是閘道器路由會被 忽略。如果未設定 IP_HDRINCL 則可透過 setsockopt (2) 在 raw socket 中設定 IP header 選項。參考 ip (7) 瞭解更多信 息。
在 Linux 2.2 下可以用 IP socket 選項設定所有的 IP 報頭域和選項. 這意味著通常只有新的協議 或沒有使用者介面的協議需要 raw socket (就象 ICMP). 當收到一個包時,它首先被傳給繫結到包協議的任何 raw socket 然後才傳給其他協議控制代碼(handler)。 (比如.核心協議模組).
地址格式
raw socket 使用在 ip (7) 中定義的標準 sockaddr_in 地址結構。 sin_port 域用於指定 IP 協議號,但是在 Linux 2.2 下傳送時應將 其忽略,而且應該一直設為0 (參見 BUGS).
對於接收的包,sin_port 被設定為該包的協議號。 參考 其中包括介紹有效的 IP 協議的檔案.
SOCKET選項
raw socket 選項可使用 setsockopt (2) 進行設定,用 getsockopt (2)進行讀取(透過傳遞 SOL_RAW 族標誌).
- ICMP_FILTER
- 啟用繫結到 IPPROTO_ICMP
協議的一個用於 raw socket
特殊的過濾器。
該值對每種 ICMP
訊息都有一個位(掩碼),
可以把那種 ICMP
訊息過濾掉.預設時是不過濾
ICMP 訊息.
另外,還支援所有對資料報 socket 有效的 ip(7) SOL_IP socket 選項.
注 意
raw socket 包長超過介面 MTU 時會把包分成碎片。(另見 BUGS). 另一個更友好和快速的選擇是使用路徑 MTU 查詢。 在 ip (7) IP_PMTU_DISCOVER 一段有詳細描述。
使用 bind (2) 可將 raw socket 繫結到指定的本地地址。 如果沒有繫結,則接收所有符合指定的 IP 協議的包。 另外用 SO_BINDTODEVICE 可以將 RAW socket 繫結到指定的網路 裝置。 詳見: socket (7).
IPPROTO_RAW 只能傳送。如果你確實想接收所有的 IP 包 用 packet (7) socket 和 ETH_P_IP 協議. 請注意 packet socket不象 raw socket 那樣對 IP 碎片進行重組。
如果想要為一個 datagram socket 接收的所有 ICMP 包,那麼最好 在那個 socket 上使用 IP_RECVERR。詳見: ip (7).
raw socket 能竊聽所有的 IP 協議, 即使象 ICMP 或 TCP 這樣在核心中有協議模組的也不例外。這時候包會同時傳送到 核心模組和raw socket. 一個可移植的程式不能依賴這個特性, 許多其他 BSD socket 實現在這方面有侷限.
Linux 從不改變使用者傳輸的包 (除了前 面提到的 IP_HDRINCL ,填入一些0欄位).這與其他 raw socket 實現方式是不同的.
RAW socket 通常很難移植. socket 傳輸時使用 sin_port 中設定的 協議,但 Linux2.2 下不行了,解決辦法是使用 IP_HDRINCL.
錯誤處理
只有連線了 socket 或 IP_RECVERR 設定為有效時,網路錯誤才會 傳送給使用者。因為相容性的原因只有 EMSGSIZE 和 EPROTO 被傳送 給 socket.
錯 誤
- IP_RECVERR
- 使得所有的錯誤儲存到 error queue(錯誤佇列).
- EMSGSIZE
- 包太大。或者因為路徑 MTU 查詢 (IP_PMTU_DISCOVER) 設定為有效,或者因為包的尺寸超過 IPv4 規定的包 最大尺寸 64KB.
- EACCES
- 使用者試圖傳送到某廣播地址但是並未事先在socket中設定廣播 標誌。
- EPROTO
- ICMP 錯誤報告有引數問題。
- EFAULT
- 無效記憶體地址。
- EOPNOTSUPP
- 傳送給 socket 的標誌無效(比如:MSG_OOB ).
- EINVAL
- 無效引數.
- EPERM
- 使用者無權開啟 raw socket. 只有使用者 id 為 0 或具有 CAP_NET_RAW 屬性方可。
版 本
IP_RECVERR 和 ICMP_FILTER 是 Linux 2.2 的新實現. 不能用於可移植程式。
如果設定了 SO_BSDCOMPAT 標誌, Linux 2.0 裡面有和 BSD 裡相容的 raw socket 程式碼錯誤, 在 2.2 裡已經修補了.
BUGS
沒有描述透明代理擴充套件.
當設定 IP_HDRINCL 選項後datagrams(自定址資料包)不會被分段 並受 MTU 限制. 這是 Linux 2.2 的限制.
在 Linux 2.2 sin_port 中設定的 IP 協議會丟失。使用的是綁定了 socket 的協議,或在 socket (2)初始化呼叫中指定的協議。
作 者
Andi Kleen.
另 見
ip(7), socket(7), recvmsg(2), sendmsg(2).
RFC1191 for path MTU discovery.
RFC791 and the include file for the IP protocol.
[中文版維護人]
RedCandle <redcandle51@chinaren.com>
[中文版最新更新]
2000/10/15
《中國linux論壇man手冊頁翻譯計劃》:
http://cmpp.linuxforum.net
跋
本頁面中文版由中文
man 手冊頁計劃提供。
中文 man
手冊頁計劃:https://github.com/man-pages-zh/manpages-zh
| 2 Oct 1998 | Linux 手冊頁 |