ttdbserverd

user cmd

`ttdbserverd`

RPC-based ToolTalk database server

    rpc.ttdbserverd
    -G
    -m DTMOUNTPOINT_value
    -n

    -v
    -?

## DESCRIPTION

`rpc.ttdbserverd` 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 `rpc.ttdbserverd` (normally started by `inetd`) runs on each host that has a local filesystem. `rpc.ttdbserverd` serves four purposes:

1. Mapping a spec to its associated file and a file to its associated specs.

2. Mapping a spec to its properties.

3. Mapping a file to a list of sessions with clients having patterns registered in the scope of that file.

4. Answering netfile queries; see &cdeman.tt.file.netfile; and &cdeman.tt.host.file.netfile;.

For each filesystem that `rpc.ttdbserverd` needs to store information about, it creates a directory called `TT_DB` 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 `rpc.ttdbserverd` can be told, via `partition_map`(4), to create the databases in another local partition. If `rpc.ttdbserverd` is not installed on a particular file server, ToolTalk can be told, via `hostname_map`(4), to manage that file server's partitions using the `rpc.ttdbserverd` on a different host.

## OPTIONS

-G

- Perform garbage collection. This cleans up the `TT_DB` directories and the associated internal database files.

-m `DTMOUNTPOINT_value`

- Sets the `DTMOUNTPOINT` environment variable for `rpc.ttdbserverd`. If there is already an environment variable called `DTMOUNTPOINT`, -m will override it.

-n

- 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.

-v

- Print out the version number.

-?

- Prints out the command usage information.

## ENVIRONMENT

DTMOUNTPOINT

- If set, the value of this environment variable will be used in place of `/net` in pathnames constructed to answer &cdeman.tt.host.netfile.file; queries. This environment variable can also be set by using the -m flag for `rpc.ttdbserverd`.

TT_PARTITION_MAP

- If set, the value of this environment variable will be used in place of `/etc/tt/partition_map`. See `partition_map`(4).

## FILES

TT_DB/*

- spec and session database files are kept in the TT_DB directory under each disk partition mount point.

tt/hostname_map

- Host redirection map. See `hostname_map`(4).

/etc/tt/partition_map

- Partition redirection map. See `partition_map`(4).

## SEE ALSO

&cdeman.ttsession;, &cdeman.tt.file.netfile;, &cdeman.tt.host.file.netfile;, &cdeman.tt.spec.create;, `hostname_map`(4), `partition_map`(4)