Debian GNU/Hurd
Dirk Ritter m'a envoyé le texte suivant, qui contient la sortie de l'option --help de chaque programme serveur du Hurd. Cela peut être un bon point de départ pour une documentation plus poussée des programmes serveur, particulièrement ceux employés par les utilisateurs, comme ext2fs, ufs, isofs, ftpfs, crash, etc.
Depuis, j'ai mis à jour le texte en utilisant des extraits de courriers électroniques provenant de la liste de diffusion du Hurd. Merci à Martin von Loewis.
Description préliminaire de l'interface utilisateur de GNU/Hurd
Actuellement, il n'y a presque rien, mais cela est toujours mieux que rien du tout, alors veuillez envoyer vos plaintes, corrections et ajouts à Dirk Ritter, <dirk@gnumatic.s.bawue.de>. Veuillez noter que mes compétences en programmation sont très limitées, alors vous ne devriez pas attendre de moi de comprendre effectivement quoi que ce soit au sujet du design et des implémentations des systèmes d'exploitation.
| Le serveur d'authentification | "auth" |
|---|---|
| Le serveur d'arrêt inopiné | "crash" |
| Le serveur d'exécution | "exec" |
| Le serveur du système de fichiers ext2 | "ext2fs" |
| Le traducteur fifo | "fifo" |
| Le traducteur firmlink | "firmlink" |
| Le traducteur du système de fichiers FTP | "ftpfs" |
| Le serveur de retransmission | "fwd" |
| Le serveur hostmux | "hostmux" |
| Le serveur ifsock | "ifsock" |
| Le serveur d'initialisation | "init" |
| Le serveur du système de fichiers iso | "isofs" |
| Le serveur magique | "magic" |
| Le serveur new-fifo | "new-fifo" |
| Le serveur NFS | "nfs" |
| Le serveur null | "null" |
| Le serveur pfinet | "pfinet" |
| Le serveur pflocal | "pflocal" |
| Le serveur de processus | "proc" |
| Le traducteur de stockage | "storeio" |
| Le traducteur de lien symbolique | "symlink" |
| Le serveur de terminal | "term" |
| Le serveur ufs | "ufs" |
| Le serveur de usermux | "usermux" |
Le serveur d'authentification – "auth"
Échange les mots de passes de deux serveurs qui ne se font pas mutuellement confiance quand ils communiquent. Dans un sens, chaque serveur d'authentification établit un domaine de confiance (Martin von Loewis, 10 Oct 1996).
Une de ses fonctionnalités intéressantes est la possibilité pour un processus de prendre plusieurs identités à la fois, et aussi d'acquérir ou de perdre dynamiquement des identités.
Lancer "/hurd/auth --help" donne :
Usage: auth [OPTION...]
-?, --help Give this help list
--usage Give a short usage message
-V, --version Print program version
Report bugs to bug-hurd@gnu.org.
Le serveur d'arrêt inopiné – "crash"
Le serveur d'arrêt inopiné s'active à chaque fois qu'une tâche reçoit un signal d'erreur fatale, par exemple parce qu'elle viole les limites de mémoires (erreur de segmentation). Le serveur d'arrêt inopiné possède trois modes de fonctionnement : en suspendant le groupe de processus (« pgrp ») de la tâche offensante, en le tuant ou en réalisant un fichier de vidage mémoire. Ce dernier moyen n'est pas encore implémenté. Pensez au serveur d'arrêt inopiné comme à un airbag.
Vous pouvez évidemment positionner le mode d'opération avec
settrans, mais aussi avec fsysopts au moment
de l'exécution. Cela est vrai pour le mode par défaut du système
et nécessite habituellement les privilèges de superutilisateur.
Un utilisateur peut choisir un mode par défaut différent avec la
variable d'environnement CRASHSERVER. Vous positionnez
cette variable à un inode auquel est attaché le serveur
crash. Sur un système Debian GNU/Linux par défaut, ces
trois opérations par défaut ont des traducteurs respectifs dans
/servers/crash-*.
These options specify the disposition of a crashing process:
-s, --suspend Suspend the process
-k, --kill Kill the process
-c, --core-file Dump a core file
--dump-core
Le serveur d'exécution – "exec"
Le serveur d'exécution gère la création d'une nouvelle image de processus à partir du fichier image.
En fait ce serveur est capable de créer une image de processus exécutable à partir de n'importe quel fichier d'image reconnu par la bibliothèque BFD (cela inclut a.out, ELF et bien d'autres). Les exécutables gzippés sont aussi reconnu (ce qui est utile pour les disquettes d'amorçage).
Lancer "/hurd/exec --help" donne :
Usage: exec [OPTION...]
Hurd standard exec server
-?, --help Give this help list
--usage Give a short usage message
-V, --version Print program version
Report bugs to bug-hurd@gnu.org.
Le serveur du système de fichiers ext2 – "ext2fs"
Ce serveur s'occupe des systèmes de fichiers de type ext2. Il
fait la même chose que ext2fs.static, sauf que
ext2fs.static est un exécutable lié statiquement.
Lancer "/hurd/ext2fs --help" donne :
Usage: ext2fs [OPTION...] DEVICE...
If neither --interleave or --layer is specified, multiple DEVICEs are
concatenated.
-E, --no-exec Don't permit any execution of files on this
filesystem
-I, --interleave=BLOCKS Interleave in runs of length BLOCKS
-L, --layer Layer multiple devices for redundancy
-n, --no-sync Don't automatically sync data to disk
-r, --readonly Never write to disk or allow opens for writing
-s, --sync[=INTERVAL] If INTERVAL is supplied, sync all data not
actually written to disk every INTERVAL seconds,
otherwise operate in synchronous mode (the default
is to sync every 30 seconds)
-S, --no-suid Don't permit set-uid or set-gid execution
-T, --store-type=TYPE Each DEVICE names a store of type TYPE
-w, --writable Use normal read/write behavior
Boot options:
--bootflags=FLAGS
-C, --directory=DIRECTORY
--device-master-port=PORT
--exec-server-task=PORT
--host-priv-port=PORT
-?, --help Give this help list
--usage Give a short usage message
-V, --version Print program version
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
If neither --interleave or --layer is specified, multiple DEVICEs are
concatenated.
Report bugs to bug-hurd@gnu.org.
Le serveur fifo – "fifo"
Le traducteur fifo implémentant les files nommées.
Lancer "/hurd/fifo --help" donne :
Usage: fifo [OPTION...]
Translator for fifos
-d, --dgram Reads reflect write record boundaries
-m, --multiple-readers Allow multiple simultaneous readers
-n, --noblock Don't block on open
-?, --help Give this help list
--usage Give a short usage message
-V, --version Print program version
Report bugs to bug-hurd@gnu.org.
Le serveur firmlink – "firmlink"
Un traducteur pour firmlinks.
Lancer "/hurd/firmlink --help" donne :
Usage: firmlink [OPTION...] TARGET
A translator for firmlinks
-?, --help Give this help list
--usage Give a short usage message
-V, --version Print program version
A firmlink is sort of half-way between a symbolic link and a hard link;
Like a symbolic link, it is `by name', and contains no actual reference to the
target. However, the lookup returns a node which will redirect parent lookups
so that attempts to find the cwd that go through the link will reflect the link
name, not the target name. The target referenced by the firmlink is looked up
in the namespace of the translator, not the client.
Report bugs to bug-hurd@gnu.org.
Le serveur du système de fichiers FTP – "ftpfs"
Un serveur pour serveurs de fichiers FTP.
Lancer "/hurd/ftpfs --help" donne :
Usage: ftpfs [OPTION...] REMOTE_FS [SERVER]
Hurd ftp filesystem translator
-D, --debug[=FILE] Print debug output to FILE
Parameters:
--bulk-stat-period=SECS Period for detecting bulk stats (default 10)
--bulk-stat-threshold=SECS Number of stats within the bulk-stat-period
that trigger a bulk stat (default 5)
--name-timeout=SECS Time directory names are cached (default 300)
--node-cache-size=ENTRIES Number of recently used filesystem nodes that
are cached (default 50)
--stat-timeout=SECS Time stat information is cached (default 120)
-?, --help Give this help list
--usage Give a short usage message
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
If SERVER is not specified, an attempt is made to extract it from REMOTE_FS,
using `SERVER:FS' notation. SERVER can be a hostname, in which case anonymous
ftp is used, or may include a user and password like `USER:PASSWORD@HOST' (the
`:PASSWORD' part is optional).
Report bugs to bug-hurd@gnu.org.
Le serveur de retransmission – "fwd"
Quand il reçoit un accès, le traducteur fwd retransmet
les requêtes à un autre serveur. Il est utilisé dans les serveurs
fifo et symlink. L'idée est telle que vous
n'ayez pas besoin de trente-six millions de serveurs pour réaliser
des opérations aussi triviales ; fwd est utilisé
pour coordonner un serveur qui doit commodément traiter avec plusieurs
nœuds différents.
Lancer "/hurd/fwd --help" donne :
Usage: /hurd/fwd SERVER [TRANS_NAME [TRANS_ARG...]]
Le serveur hostmux – "hostmux"
Je n'ai aucune idée de ce à quoi ce serveur sert.
(un serveur pour les résolutions de nom d'hôte ?)
Lancer "/hurd/hostmux --help" donne :
Usage: hostmux [OPTION...] TRANSLATOR [ARG...]
A translator for invoking host-specific translators
-H, --host-pattern=PAT The string to replace in the translator
specification with the hostname; if empty, or
doesn't occur, the hostname is appended as
additional argument instead (default `${host}')
-?, --help Give this help list
--usage Give a short usage message
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
This translator appears like a directory in which hostnames can be looked up,
and will start TRANSLATOR to service each resulting node.
Report bugs to bug-hurd@gnu.org.
Le serveur ifsock – "ifsock"
ifsock ne traite que les nœuds S_IFSOCK
de système de fichiers pour les systèmes de fichiers filesystem qui ne
le font pas eux-mêmes, en agissant comme un point d'accroche sur lequel
accrocher les adresses de socket de domaine Unix. pfinet
et pflocal implémentes l'API socket (Thomas
Bushnell, 10 octobre 1996).
Lancer "/hurd/ifsock --help" donne :
/hurd/ifsock: Must be started as a translator
Le serveur d'initialisation – "init"
Un serveur pour les procédures d'amorçage du système et les configurations pour le moment de l'exécution.
Lancer "/hurd/init --help" donne :
Usage: init [OPTION...]
Start and maintain hurd core servers and system run state
-d, --debug
-f, --fake-boot This hurd hasn't been booted on the raw machine
-n, --init-name
-q, --query Ask for the names of servers to start
-s, --single-user Startup system in single-user mode
-?, --help Give this help list
--usage Give a short usage message
-V, --version Print program version
Report bugs to bug-hurd@gnu.org.
Le serveur du système de fichiers iso – "isofs"
Un serveur pour les systèmes de fichiers de type ISO, utilisés communément sur les CD.
Lancer "/hurd/isofs --help" donne :
Usage: isofs [OPTION...] DEVICE...
If neither --interleave or --layer is specified, multiple DEVICEs are
concatenated.
-E, --no-exec Don't permit any execution of files on this
filesystem
-I, --interleave=BLOCKS Interleave in runs of length BLOCKS
-L, --layer Layer multiple devices for redundancy
-n, --no-sync Don't automatically sync data to disk
-r, --readonly Never write to disk or allow opens for writing
-s, --sync[=INTERVAL] If INTERVAL is supplied, sync all data not
actually written to disk every INTERVAL seconds,
otherwise operate in synchronous mode (the default
is to sync every 30 seconds)
-S, --no-suid Don't permit set-uid or set-gid execution
-T, --store-type=TYPE Each DEVICE names a store of type TYPE
-w, --writable Use normal read/write behavior
Boot options:
--bootflags=FLAGS
-C, --directory=DIRECTORY
--device-master-port=PORT
--exec-server-task=PORT
--host-priv-port=PORT
-?, --help Give this help list
--usage Give a short usage message
-V, --version Print program version
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
If neither --interleave or --layer is specified, multiple DEVICEs are
concatenated.
Report bugs to bug-hurd@gnu.org.
Le serveur magique – "magic"
Un traducteur qui renvoie le résultat de nouvel essai magique
MAGIC.
Les utilisateurs finaux normaux n'auront probablement pas besoin d'en savoir beaucoup à son propos, puisqu'il est utilisé, par exemple, pour faciliter les entrées et sorties du terminal. Les développeurs pourront tirer profit des éléments d'informations qu'a donnés Thomas Bushnell :
La clé est ici de savoir ce qu'est un "résultat de nouvel essai magique" ("magic retry result"). La chose à faire est de regarder le RPC
dir_lookupqui est documenté dans<hurd/fs.defs>et<hurd/hurd_types.defs>.
Les résultats de consultation de Magic sont basiquement obtenus dans les cas où la consultation a besoin d'informations qui font partie de l'état d'appel du processus, et non de la procédure normale de consultation de nom. Ces états ("punt to caller's state") doivent chacun être spécialement implémentés dans la bibliothèque C (voirlibc/hurd/hurdlookup.c), et couvrir les cas connus, afin de proposer les fonctionnalités fournies par bien d'autres systèmes.
Il a aussi gentiment expliqué un comportement particulier qui embrouille l'utilisateur final moyen quand ils le rencontrent pour la première fois :
L'incapacité de faire "ls /dev/fd" est due au fait que le traducteur ne connaît pas les descripteurs de fichiers qui sont ouverts. Il ne peut alors pas vous dire lesquels existent. Mais son comportement est parfaitement identique sur les autres systèmes.
Lancer "/hurd/magic --help" donne :
Usage: magic [OPTION...] MAGIC
A translator that returns the magic retry result MAGIC
-?, --help Give this help list
--usage Give a short usage message
-V, --version Print program version
Report bugs to bug-hurd@gnu.org.
Le serveur new-fifo – "new-fifo"
Serveur alternatif pour files nommées.
Lancer "/hurd/new-fifo --help" donne :
Usage: new-fifo [OPTION...]
-d, --dgram Reflect write record boundaries
-n, --noblock Don't block on open
-r, --multiple-readers Allow multiple simultaneous readers
-s, --server Operate in server mode
-S, --standalone Don't attempt to use a fifo server
-U, --use-server=NAME Attempt use server NAME
-?, --help Give this help list
--usage Give a short usage message
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
Report bugs to bug-hurd@gnu.org.
Le serveur de systèmes de fichiers en réseau – "nfs"
Gestion de systèmes de fichiers en réseau pour le systèmes de fichiers en réseau de SUN (NFS).
Lancer "/hurd/nfs --help" donne :
Usage: nfs [OPTION...] REMOTE_FS [HOST]
Hurd nfs translator
-h, --hard Retry file systems requests until they succeed
-s, --soft[=RETRIES] File system requests will eventually fail, after
RETRIES tries if specified, otherwise 3
-R, --read-size=BYTES, --rsize=BYTES
Max packet size for reads (default 8192)
-W, --write-size=BYTES, --wsize=BYTES
Max packet size for writes (default 8192)
Timeouts:
--cache-timeout=SEC Timeout for cached file data (default 3)
--init-transmit-timeout=SEC
--max-transmit-timeout=SEC
--name-cache-neg-timeout=SEC
Timeout for negative directory cache entries
(default 3)
--name-cache-timeout=SEC Timeout for positive directory cache entries
(default 3)
--stat-timeout=SEC Timeout for cached stat information (default 3)
Server specification:
--default-mount-port=PORT Port for mount server, if none can be found
automatically
--default-nfs-port=PORT Port for nfs operations, if none can be found
automatically
--mount-port=PORT Port for mount server
--mount-program=ID[.VERS]
--nfs-port=PORT Port for nfs operations
--nfs-program=ID[.VERS]
--pmap-port=SVC|PORT
-?, --help Give this help list
--usage Give a short usage message
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
If HOST is not specified, an attempt is made to extract it from REMOTE_FS,
using either the `HOST:FS' or `FS@HOST' notations.
Report bugs to bug-hurd@gnu.org.
Le lavabo de la cuisine – "null"
Un serveur à beaucoup d'espace libre et plein de zéros. Implémente
/dev/null et /dev/zero.
Lancer "/hurd/null --help" donne :
Usage: null [OPTION...]
Endless sink and null source
-?, --help Give this help list
--usage Give a short usage message
-V, --version Print program version
Report bugs to bug-hurd@gnu.org.
Le serveur TCP/IP – "pfinet"
Un serveur pour TCP/IP, qui implémente la famille de protocoles PF_INET (IPv4). Le serveur qui implémentera la famille de protocoles IPv6 sera appelé pfinet6, dans le schéma actuel.
Mettre cela en place n'est pas dur du tout. C'est toujours placé dans
/servers/socket/2, parce que c'est là que la glibc le
cherchera. Soyez donc sûr de l'installer ainsi :
settrans /servers/socket/2 /hurd/pfinet -6 /servers/socket/26 --interface=/dev/eth0 OPTIONS et
settrans /servers/socket/26 /hurd/pfinet -4 /servers/socket/2 --interface=/dev/eth0 OPTIONS, où
OPTIONS indique les adresse IP, masque de sous-réseau et
passerelle (s'il en est). Seule une interface réseau est actuellement
supportée. Plus tard, vous pourrez aussi ajouter d'autres interfaces
comme eth1 et ainsi de suite avec la même commande.
Si vous n'avez pas de carte réseau, vous devriez au moins installer
l'interface de bouclage (« loopback »), afin que l'hôte
local (« localhost ») fonctionne (important pour le
système d'impression et autres choses utiles). Faites-le avec la
commande susmentionnée, mais ne spécifiez aucune interface ni
OPTIONS. Un simple settrans /servers/socket/1
/hurd/pfinet suffira.
Lancer "/hurd/pfinet --help" donne :
Swansea University Computer Society TCP/IP for NET3.019
IP Protocols: ICMP, UDP, TCP
Usage: pfinet [OPTION...]
Interface-specific options before the first interface specification apply to
the first following interface; otherwise they apply to the previously specified
interface.
-i, --interface=DEVICE Network interface to use
These apply to a given interface:
-a, --address=ADDRESS Set the network address
-g, --gateway=ADDRESS Set the default gateway
-m, --netmask=MASK Set the netmask
-s, --shutdown Shut it down
-?, --help Give this help list
--usage Give a short usage message
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
Report bugs to bug-hurd@gnu.org.
Le serveur pflocal – "pflocal"
Implémente les sockets de domaine UNIX. Nécessaire pour les files, par exemple.
Lancer "/hurd/pflocal --help" donne :
Usage: /hurd/pflocal
Le serveur de processus – "proc"
Le serveur de processus assigne les PID et les structures de processus
aux tâches, et gère tout ce qui se trouve au niveau processus comme
wait, des choses comme fork, la gestion de la
bibliothèque C.
Lancer "/hurd/proc --help" donne :
Usage: proc [OPTION...]
Hurd process server
-?, --help Give this help list
--usage Give a short usage message
-V, --version Print program version
Report bugs to bug-hurd@gnu.org.
Le traducteur de stockage – "storeio"
Un traducteur pour périphériques de stockages.
Lancer "/hurd/storeio --help" donne :
Usage: storeio [OPTION...] DEVICE...
Translator for devices and other stores
-I, --interleave=BLOCKS Interleave in runs of length BLOCKS
-L, --layer Layer multiple devices for redundancy
-n, --rdev=ID The stat rdev number for this node; may be either
a single integer, or of the form MAJOR,MINOR
-r, --readonly Disallow writing
-T, --store-type=TYPE Each DEVICE names a store of type TYPE
-w, --writable Allow writing
-?, --help Give this help list
--usage Give a short usage message
-V, --version Print program version
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
If neither --interleave or --layer is specified, multiple DEVICEs are
concatenated.
Report bugs to bug-hurd@gnu.org.
Le serveur de lien symbolique – "symlink"
Un serveur de liens symboliques pour les systèmes de fichiers qui ne les gèrent pas eux-mêmes.
Lancer "/hurd/symlink --help" donne :
?(Il n'y a aucune sortie ? Comme c'est étrange...)
Le serveur terminal – "term"
Implémente un terminal POSIX.
Lancer "/hurd/term --help" donne :
Usage: term ttyname type arg
Le serveur ufs – "ufs"
Un serveur pour les systèmes de fichiers ufs-type. Il fait la même chose
qu'ufs.static, sauf qu'ufs.static est un
exécutable lié statiquement.
Lancer "/hurd/ufs --help" donne :
Usage: ufs [OPTION...] DEVICE...
If neither --interleave or --layer is specified, multiple DEVICEs are
concatenated.
-C, --compat=FMT FMT may be GNU, 4.4, or 4.2, and determines which
filesystem extensions are written onto the disk
(default is GNU)
-E, --no-exec Don't permit any execution of files on this
filesystem
-I, --interleave=BLOCKS Interleave in runs of length BLOCKS
-L, --layer Layer multiple devices for redundancy
-n, --no-sync Don't automatically sync data to disk
-r, --readonly Never write to disk or allow opens for writing
-s, --sync[=INTERVAL] If INTERVAL is supplied, sync all data not
actually written to disk every INTERVAL seconds,
otherwise operate in synchronous mode (the default
is to sync every 30 seconds)
-S, --no-suid Don't permit set-uid or set-gid execution
-T, --store-type=TYPE Each DEVICE names a store of type TYPE
-w, --writable Use normal read/write behavior
Boot options:
--bootflags=FLAGS
--device-master-port=PORT
--directory=DIRECTORY
--exec-server-task=PORT
--host-priv-port=PORT
-?, --help Give this help list
--usage Give a short usage message
-V, --version Print program version
Mandatory or optional arguments to long options are also mandatory or optional
for any corresponding short options.
If neither --interleave or --layer is specified, multiple DEVICEs are
concatenated.
Report bugs to bug-hurd@gnu.org.
Le traducteur usermux – "usermux"
Un traducteur pour invoquer des traducteurs spécifiques à l'utilisateur.
Lancer "/hurd/usermux --help" donne :
Usage: usermux [OPTION...] [TRANSLATOR [ARG...]]
A translator for invoking user-specific translators
-C, --clear-patterns Reset all patterns to empty; this option may then
be followed by options to set specific patterns
--home-pattern=PAT The string to replace in the translator
specification with the user's home directory
(default `${home}')
--uid-pattern=PAT The string to replace in the translator
specification with the uid (default `${uid}')
--user-pattern=PAT The string to replace in the translator
specification with the user name (default
`${user}')
-?, --help Give this help list
--usage Give a short usage message
This translator appears like a directory in which user names can be looked up,
and will start TRANSLATOR to service each resulting node. If no pattern occurs
in the translator specification, the users's home directory is appended to it
instead; TRANSLATOR defaults to /hurd/symlink.
Report bugs to bug-hurd@gnu.org.