svc man page on Inferno

Man page or keyword search:  
man Server   579 pages
apropos Keyword Search (all sections)
Output format
Inferno logo
[printable version]

SVC(8)									SVC(8)

NAME
       svc: auth, net, registry, rstyx, styx - start Inferno network services

SYNOPSIS
       svc/net
       svc/auth [ -n ]
       svc/registry
       svc/rstyx
       svc/styx

DESCRIPTION
       The  directory /dis/svc contains several sh(1) scripts to start network
       listeners (see listen(1)) that give remote  hosts  access  to  specific
       Inferno	services  on  the  current host.  The scripts can be edited to
       suit (or configure themselves to suit) the requirements of a particular
       site.

       A  host	that  is  not an authentication server and wishes to start the
       usual network services can simply invoke svc/net, which	runs  all  the
       others  except  authentication.	Authentication servers should normally
       run svc/auth instead, to start local name and authentication  services,
       and  a listener for each authentication service but not file service or
       remote execution.

       Auth must be run (only) on a host that is to act as  an	authentication
       server,	providing  signing and other authentication services to itself
       and the network.	 The -n flag tells it not to start  keyfs(4),  perhaps
       because	it has been started already.  The files /keydb/signerkey, cre‐
       ated by createsignerkey(8), and /keydb/keys, managed by changelogin(8),
       must  exist.   If so, auth starts keyfs(4), which prompts for the pass‐
       word that protects /keydb/keys, the file of secrets shared with	regis‐
       tered  users.  If the key file is empty, the confirmed password will be
       used in future to encrypt and decrypt the file; otherwise the  password
       must  match  the	 one used to encrypt the key file.  If the password is
       valid, listeners are started for keysrv(4), to allow  passwords	to  be
       changed	remotely,  logind(8),  to  provide  signed  certificates,  and
       signer(8).  Note that although an authentication server must be present
       to  run getauthinfo(8) to obtain credentials to access another service,
       once those have been issued, the	 recipient  can	 subsequently  present
       them  (if  still valid) to access that service without further involve‐
       ment by the service (ie, it need not then be running).	See  changelo‐
       gin(8)  for  the user registration program, which can be used once auth
       has started.

       Registry starts the dynamic service registry (see registry(4)) if it is
       not  already  running,  putting it at the conventional location for the
       local registry, /mnt/registry.  Initial (static)	 service  descriptions
       are  taken  from /lib/ndb/registry if it exists.	 It then starts a lis‐
       tener to give other hosts access to the registry as  a  9P  service  at
       tcp!*!registry, normally port 6675.

       Rstyx  listens  for  incoming  calls  to the rstyx service, and invokes
       rstyxd(8) to deal with each one.

       Styx listens for incoming calls to the styx service, and for each  one,
       authenticates  the  caller,  then calls export(4) to export the current
       root.

FILES
       /keydb/keys
	      encrypted file containing user secrets

       /keydb/signerkey
	      private key of authentication server

SOURCE
       /appl/svc/auth.sh
       /appl/svc/net.sh
       /appl/svc/registry.sh
       /appl/svc/rstyx.sh
       /appl/svc/styx.sh

SEE ALSO
       listen(1), export(4), keyfs(4), keysrv(4), registry(4), changelogin(8),
       createsignerkey(8), cs(8), dns(8), logind(8), rstyxd(8), signer(8)

									SVC(8)
[top]

List of man pages available for Inferno

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net