[hurd] 19/75: Add devnode documentation

[Samuel Thibault]

This is an automated email from the git hooks/post-receive script.

sthibault pushed a commit to branch dde
in repository hurd.

commit 30c4d96a509b1d61bd780543544ce75508a071af
Author: Samuel Thibault <address@hidden>
Date:   Sun Nov 29 13:32:54 2015 +0100

    Add devnode documentation
    
    * doc/hurd.texi (devnode): Add section.
---
 doc/hurd.texi | 56 +++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 55 insertions(+), 1 deletion(-)

diff --git a/doc/hurd.texi b/doc/hurd.texi
index 23c5c8a..ccd7c91 100644
--- a/doc/hurd.texi
+++ b/doc/hurd.texi
@@ -314,6 +314,9 @@ File Transfer Protocol
 
 Networking
 
+* pfinet::                     TCP/IP stack.
+* pflocal::
+* libpipe::
 * Socket Interface::            Network communication I/O protocol.
 
 Authentication
@@ -2914,11 +2917,55 @@ storeio server (FIXME xref).
 
 FIXME: finish
 
address@hidden fifo
 @section fifo
+
address@hidden ifsock
 @section ifsock
+
address@hidden magic
 @section magic
+
address@hidden null
 @section null
 
address@hidden devnode
address@hidden devnode
+
address@hidden is a translator that creates the device file for the device,
+which provides another way for other programs to open the device.
+
+Clients need to get the port to the @dfn{devnode} translator by calling
address@hidden() and uses this port as a master device port to open
+the device by calling @dfn{device_open}(). The device name used in
address@hidden() is specified by @option{--name} of @dfn{devnode}.
+
address@hidden Invoking devnode
address@hidden Invoking devnode
+
+Usage: devnode address@hidden@dots{}]
+
address@hidden @code
address@hidden address@hidden
address@hidden -n
+Define the device name used by clients in device_open().
+
address@hidden address@hidden
address@hidden -M
+Get a pseudo master device port
+
address@hidden table
+
+Mandatory or optional arguments to long options are also mandatory or optional
+for any corresponding short options.
+
+If @option{--name} is specified, the client must use the device name in
address@hidden Otherwise, any device name is acceptable.
+
address@hidden can be useful to open the virtual interface
+created by some other programs, for example by @dfn{eth-multiplexer}
+(@pxref{eth-multiplexer}).
+
 
 FIXME: a chapter on libtreefs and libdirmgt will probably go here
 
@@ -4539,12 +4586,19 @@ FIXME: finish
 FIXME: this subsystem is in flux @c Thomas, 26-03-1998
 
 @menu
+* pfinet::                     TCP/IP stack.
+* pflocal::
+* libpipe::
 * Socket Interface::            Network communication I/O protocol.
 @end menu
 
-
address@hidden pfinet
 @section pfinet
+
address@hidden pflocal
 @section pflocal
+
address@hidden libpipe
 @section libpipe
 
 @node Socket Interface

-- 
Alioth's /usr/local/bin/git-commit-notice on 
/srv/git.debian.org/git/pkg-hurd/hurd.git