220 lines
6.1 KiB
Plaintext
220 lines
6.1 KiB
Plaintext
<!-- $XConsortium: ttdbserv.sgm /main/7 1996/12/06 18:09:14 rws $ -->
|
|
<!-- (c) Copyright 1995 Digital Equipment Corporation. -->
|
|
<!-- (c) Copyright 1995 Hewlett-Packard Company. -->
|
|
<!-- (c) Copyright 1995 International Business Machines Corp. -->
|
|
<!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
|
|
<!-- (c) Copyright 1995 Novell, Inc. -->
|
|
<!-- (c) Copyright 1995 FUJITSU LIMITED. -->
|
|
<!-- (c) Copyright 1995 Hitachi. -->
|
|
|
|
<RefEntry Id="CDEMX.MAN45.rsml.1" Remap="">
|
|
<RefMeta>
|
|
<RefEntryTitle>ttdbserverd</RefEntryTitle>
|
|
<ManVolNum>user cmd</ManVolNum>
|
|
</RefMeta>
|
|
<RefNameDiv>
|
|
<RefName><Command>ttdbserverd</Command></RefName>
|
|
<RefPurpose>RPC-based ToolTalk database server
|
|
</RefPurpose>
|
|
</RefNameDiv>
|
|
<!-- (c) Copyright 1993, 1994 Sun Microsystems, Inc.-->
|
|
<!-- (c) Copyright 1993, 1994 Hewlett-Packard Company-->
|
|
<!-- (c) Copyright 1993, 1994 International Business Machines Corp.-->
|
|
<RefSynopsisDiv>
|
|
<CmdSynopsis>
|
|
<Command>rpc.ttdbserverd</Command>
|
|
<Arg Choice="opt">−G</Arg>
|
|
<Arg Choice="opt">−m <Replaceable>DTMOUNTPOINT_value</Replaceable></Arg>
|
|
<Arg Choice="opt">−n</Arg>
|
|
<!--.RB [ -t \ level]-->
|
|
<Arg Choice="opt">−v</Arg>
|
|
<Arg Choice="opt">−?</Arg>
|
|
<!-- This was disabled for release 1.0-->
|
|
<!-- [-a authentication-level]-->
|
|
</CmdSynopsis>
|
|
</RefSynopsisDiv>
|
|
<RefSect1>
|
|
<Title>DESCRIPTION</Title>
|
|
<Para><Command>rpc.ttdbserverd</Command>
|
|
manages ToolTalk objects created by
|
|
&cdeman.tt.spec.create;,
|
|
and handles certain queries related to the netfiles returned by
|
|
&cdeman.tt.file.netfile;.
|
|
One instance of
|
|
<Command>rpc.ttdbserverd</Command>
|
|
(normally started by
|
|
<Command>inetd</Command>)
|
|
runs on each host that has a local filesystem.
|
|
<Command>rpc.ttdbserverd</Command>
|
|
serves four purposes:</Para>
|
|
<OrderedList>
|
|
<ListItem>
|
|
<Para>Mapping a spec to its associated file and a file to its associated specs.
|
|
</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Mapping a spec to its properties.
|
|
</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Mapping a file to a list of sessions with clients having patterns
|
|
registered in the scope of that file.
|
|
</Para>
|
|
</ListItem>
|
|
<ListItem>
|
|
<Para>Answering netfile queries; see
|
|
&cdeman.tt.file.netfile;
|
|
and
|
|
&cdeman.tt.host.file.netfile;.
|
|
</Para>
|
|
</ListItem>
|
|
</OrderedList>
|
|
<Para>For each filesystem that
|
|
<Command>rpc.ttdbserverd</Command>
|
|
needs to store information about, it creates a directory called
|
|
<Filename>TT_DB</Filename> at the mountpoint of that file system.
|
|
In that directory
|
|
it creates the databases it needs to store its tables and indices.
|
|
If the partition is not writable, then
|
|
<Command>rpc.ttdbserverd</Command>
|
|
can be told, via
|
|
<Filename MoreInfo=RefEntry>partition_map</Filename>(4),
|
|
to create the databases in another local partition.
|
|
If
|
|
<Command>rpc.ttdbserverd</Command>
|
|
is not installed on a particular file server, ToolTalk can be
|
|
told, via
|
|
<Filename MoreInfo=RefEntry>hostname_map</Filename>(4),
|
|
to manage that file server's partitions using the
|
|
<Command>rpc.ttdbserverd</Command>
|
|
on a different host.
|
|
</Para>
|
|
</RefSect1>
|
|
<RefSect1>
|
|
<Title>OPTIONS</Title>
|
|
<VariableList>
|
|
<VarListEntry>
|
|
<Term>−G</Term>
|
|
<ListItem>
|
|
<Para>Perform garbage collection.
|
|
This cleans up the <Filename>TT_DB</Filename> directories and the
|
|
associated internal database files.
|
|
</Para>
|
|
</ListItem>
|
|
</VarListEntry>
|
|
<VarListEntry>
|
|
<Term>−m <Replaceable>DTMOUNTPOINT_value</Replaceable></Term>
|
|
<ListItem>
|
|
<Para>Sets the <SystemItem Class="EnvironVar">DTMOUNTPOINT</SystemItem>
|
|
environment variable for
|
|
<Command>rpc.ttdbserverd</Command>.
|
|
If there is already an environment variable called
|
|
<SystemItem Class="EnvironVar">DTMOUNTPOINT</SystemItem>, −m
|
|
will override it.
|
|
</Para>
|
|
</ListItem>
|
|
</VarListEntry>
|
|
<VarListEntry>
|
|
<Term>−n</Term>
|
|
<ListItem>
|
|
<Para>Turn off permission checking. Normally the protection of the file
|
|
passed to
|
|
&cdeman.tt.spec.create;
|
|
determines who may read and write that spec. This
|
|
option disables this checking and allows anyone to read and write any
|
|
spec. This option should be used with caution.
|
|
</Para>
|
|
</ListItem>
|
|
</VarListEntry>
|
|
<VarListEntry>
|
|
<Term>−v</Term>
|
|
<ListItem>
|
|
<Para>Print out the version number.
|
|
</Para>
|
|
</ListItem>
|
|
</VarListEntry>
|
|
<!--.TP-->
|
|
<!--.B \-t level-->
|
|
<!--Turns on trace level, the valid level is between 1 to 10.-->
|
|
<VarListEntry>
|
|
<Term>−?</Term>
|
|
<ListItem>
|
|
<Para>Prints out the command usage information.
|
|
</Para>
|
|
</ListItem>
|
|
</VarListEntry>
|
|
<!-- .TP-->
|
|
<!-- .B \-a authentication-level-->
|
|
<!-- Set the authentication level to either-->
|
|
<!-- .I unix-->
|
|
<!-- (the default), or to-->
|
|
<!-- .I des-->
|
|
<!-- which means to use secure RPC.-->
|
|
</VariableList>
|
|
</RefSect1>
|
|
<RefSect1>
|
|
<Title>ENVIRONMENT</Title>
|
|
<VariableList>
|
|
<VarListEntry>
|
|
<Term>DTMOUNTPOINT</Term>
|
|
<ListItem>
|
|
<Para>If set, the value of this environment variable will be used in place
|
|
of <Filename>/net</Filename> in pathnames constructed to answer
|
|
&cdeman.tt.host.netfile.file;
|
|
queries. This environment variable can also be set by using the −m
|
|
flag for <Command>rpc.ttdbserverd</Command>.
|
|
</Para>
|
|
</ListItem>
|
|
</VarListEntry>
|
|
<VarListEntry>
|
|
<Term>TT_PARTITION_MAP</Term>
|
|
<ListItem>
|
|
<Para>If set, the value of this environment variable will be used
|
|
in place of <Filename>/etc/tt/partition_map</Filename>. See
|
|
<Filename MoreInfo=RefEntry>partition_map</Filename>(4).
|
|
</Para>
|
|
</ListItem>
|
|
</VarListEntry>
|
|
</VariableList>
|
|
</RefSect1>
|
|
<RefSect1>
|
|
<Title>FILES</Title>
|
|
<VariableList>
|
|
<VarListEntry>
|
|
<Term>TT_DB/*</Term>
|
|
<ListItem>
|
|
<Para>spec and session database files are kept in the TT_DB directory
|
|
under each disk partition mount point.
|
|
</Para>
|
|
</ListItem>
|
|
</VarListEntry>
|
|
<VarListEntry>
|
|
<Term>tt/hostname_map</Term>
|
|
<ListItem>
|
|
<Para>Host redirection map. See
|
|
<Filename MoreInfo=RefEntry>hostname_map</Filename>(4).
|
|
</Para>
|
|
</ListItem>
|
|
</VarListEntry>
|
|
<VarListEntry>
|
|
<Term>/etc/tt/partition_map</Term>
|
|
<ListItem>
|
|
<Para>Partition redirection map. See
|
|
<Filename MoreInfo=RefEntry>partition_map</Filename>(4).
|
|
</Para>
|
|
</ListItem>
|
|
</VarListEntry>
|
|
</VariableList>
|
|
</RefSect1>
|
|
<RefSect1>
|
|
<Title>SEE ALSO</Title>
|
|
<Para>&cdeman.ttsession;,
|
|
&cdeman.tt.file.netfile;,
|
|
&cdeman.tt.host.file.netfile;,
|
|
&cdeman.tt.spec.create;,
|
|
<Filename MoreInfo=RefEntry>hostname_map</Filename>(4),
|
|
<Filename MoreInfo=RefEntry>partition_map</Filename>(4)
|
|
</Para>
|
|
</RefSect1>
|
|
</RefEntry>
|