head 1.3;
access;
symbols;
locks; strict;
comment @# @;
1.3
date 93.04.14.21.32.02; author paul; state Exp;
branches;
next 1.2;
1.2
date 92.08.30.21.57.03; author paul; state Exp;
branches;
next 1.1;
1.1
date 92.08.01.03.01.21; author paul; state Exp;
branches;
next ;
desc
@@
1.3
log
@Added docs for -q.
@
text
@.TH QI 8L "30-Jul-1992"
SH NAME
qi \- the CCSO Nameserver server (on-line phone book)
SH SYNOPSIS
B qi
RB [ \-w ]
RB [ \-d ]
RB [ \-q ]
SH DESCRIPTION
PP
I Qi
manages the database of the CCSO Nameserver.
It is the "server" program of the server-client pair that make up the
CCSO Nameserver (the client program is
IR ph (1)).
PP
If given the
B \-w
option,
I qi
will run in read-only mode;
commands that would change the database are not allowed.
If given the
B \-d
option,
I qi
will be run as though invoked by a daemon; in this case,
I qi
will limit the amount of cpu time it will consume.
PP
\-q
will cause prompts to be omitted even when run from a tty or pipe.
PP
I Qi
operates in "super-user" mode when run with its standard
input is a terminal, file, or pipe.
If its standard input is none of the above
(implying the connection comes from over the network)
it runs in anonymous mode, and the operations that may be performed are limited.
PP
IR Qi 's
availability may be controlled by the file
IR /nameserv/db/prod.sta .
If this file exists, and the first word in it is "read",
then all invocations of
I qi
will be in read-only mode; no writing of the database will be allowed.
If the first word of the file is not "read",
I qi
will refuse to run at all.
In either case, the remainder of
I /nameserv/db/prod.sta
will be printed by
I qi
as the reason the database is unavailable.
SH FILES
/nameserver/db/prod.{dir,dov,idx,iov,seq,bdx} \- the database
br
/nameserver/db/LockFile \-
IR flock (3)
lock file for the database
br
/nameserv/db/prod.sta \- control file for the database.
SH "SEE ALSO"
IR "The CCSO Nameserver \- An Introduction" ,
by Steven Dorner; updated by Paul Pomes.
br
IR "The CCSO Nameserver \- A Description" ,
by Steven Dorner; updated by Paul Pomes.
br
IR "The CCSO Nameserver \- Why" ,
by Steven Dorner; updated by Paul Pomes.
br
IR "The CCSO Nameserver \- Server\-Client Protocol" ,
by Steven Dorner; updated by Paul Pomes.
br
IR "How To Rebuild A Nameserver Database, In 24 Easy Steps" ,
by Steven Dorner; updated by Paul Pomes.
br
IR "The CCSO Nameserver \- Guide To Installation" ,
by Steven Dorner; updated by Paul Pomes.
br
IR "The CCSO Nameserver \- A Programmer's Guide" ,
by Steven Dorner; updated by Paul Pomes.
br
IR ph (1)
SH AUTHOR
Parts written by Steven Dorner (sdorner@@qualcomm.com), Qualcomm, Inc.
(formerly at the University of Illinois Computing and Communications
Services Office)
PP
Parts derived from the CSNET Name Server.
PP
Code is now maintained by Paul Pomes (p\-pomes@@uiuc.edu),
University of Illinois Computing and Communications Services Office.
@
1.2
log
@Updated references.
@
text
@d8 1
d30 3
@
1.1
log
@Initial revision
@
text
@d3 1
a3 1
qi \- the CCSO Nameserver (on-line phone book)
d31 2
a32 2
operates in "super-user"
mode when run with its standard input is a terminal, file, or pipe.
d37 2
a38 1
IR Qi 's availability may be controlled by the file
a51 1
PP
a52 1
PP
d61 2
a62 2
IR "The CCSO Nameserver, An Introduction" ,
by Steven Dorner
d64 2
a65 2
IR "The CCSO Nameserver, A Description" ,
by Steven Dorner
d67 2
a68 2
IR "The CCSO Nameserver, Why" ,
by Steven Dorner
d70 2
a71 2
IR "The CCSO Nameserver, Server\-Client Protocol" ,
by Steven Dorner
d74 1
a74 1
by Steven Dorner
d76 2
a77 2
IR "The CCSO Nameserver, Guide To Installation" ,
by Steven Dorner
d79 2
a80 2
IR "The CCSO Nameserver, A Programmer's Guide" ,
by Steven Dorner
d84 3
a86 3
PP
Parts written by Steven Dorner, Computing Services Office,
University of Illinois.
d90 2
a91 2
Code package now maintained and developed by Paul Pomes, Computing and
Communications Services Office, University of Illinois.
@
