diff options
| author | Thomas Schwinge <thomas@schwinge.name> | 2010-12-13 17:11:51 +0100 |
|---|---|---|
| committer | Thomas Schwinge <thomas@schwinge.name> | 2010-12-13 17:11:51 +0100 |
| commit | 2d75167da62e3486836e5f1773e5f1ab06e43fe8 (patch) | |
| tree | e44fc83e0b1419836d1b21652ad1d38b8d0af2c4 /hurd/networking.mdwn | |
| parent | 217998d56f5b6424a685f8c87f2c0e924d1c89da (diff) | |
| parent | 5c5c16e265d8ef56b71f319885f32bf144bdea23 (diff) | |
Merge branch 'master' into external_pager_mechanism
Conflicts:
microkernel/mach/external_pager_mechanism.mdwn
Diffstat (limited to 'hurd/networking.mdwn')
| -rw-r--r-- | hurd/networking.mdwn | 33 |
1 files changed, 33 insertions, 0 deletions
diff --git a/hurd/networking.mdwn b/hurd/networking.mdwn new file mode 100644 index 00000000..bdf9def2 --- /dev/null +++ b/hurd/networking.mdwn @@ -0,0 +1,33 @@ +[[!meta copyright="Copyright © 2000, 2008, 2010 Free Software Foundation, +Inc."]] + +[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable +id="license" text="Permission is granted to copy, distribute and/or modify this +document under the terms of the GNU Free Documentation License, Version 1.2 or +any later version published by the Free Software Foundation; with no Invariant +Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license +is included in the section entitled [[GNU Free Documentation +License|/fdl]]."]]"""]] + +For each supported `PF_*` protocol family, there is a file `/servers/socket/N` +where `N` is the numberic value fo the `PF_*` symbol. Right now +[[`PF_LOCAL`|translator/pflocal]] (a.k.a. `PF_UNIX`) and +[[`PF_INET`|translator/pfinet]] (together with +[[`PF_INET6`|translator/pfinet/ipv6]]) are supported. + +User programs open those files, and use the `socket_create` [[RPC]] to make a +new socket. With that socket, they can use the other `socket_*` RPCs and also +the `io_*` RPCs. The `socket_*` RPCs are essentially clones of the [[Unix]] +[[system call]]s in question. + +The only exception is `sockaddrs`, which are implemented as [[ports|libports]] +instead of the opaque data arrays they are in the system calls. You manipulate +`sockaddr` ports with the `socket_create_address`, `socket_fabricate_address`, +and `socket_whatis_address` calls. The `sockaddr` port is then used in socket +calls like `socket_connect` and `socket_accept`. + +`PF_INET` `sockaddr` ports are manipulated with `socket_create_address` from +the usual `struct sockaddr_in`. `PF_LOCAL` `sockaddr` ports are stored by +`S_IFSOCK` filesystem nodes; you find the address associated with a node with +`ifsock_getsockaddr`. The [[file_system_server|translator]] will get a +`sockaddr` to return with `socket_fabricate_address`. |