ttdbserver - based ToolTalk database server
rpc.ttdbserverd [-G] [-m DTMOUNTPOINT_value] [-n] [-v] [-?]
ttdbserver(8) ToolTalk Commands ttdbserver(8)
NAME
ttdbserver, rpc.ttdbserverd - RPC-based ToolTalk database server
SYNOPSIS
rpc.ttdbserverd [-G] [-m DTMOUNTPOINT_value] [-n] [-v] [-?]
DESCRIPTION
rpc.ttdbserverd manages ToolTalk objects created by tt_spec_create(3),
and handles certain queries related to the netfiles returned by
tt_file_netfile(3). One instance of rpc.ttdbserverd (normally started
by inetd) runs on each host that has a local filesystem. rpc.ttdb-
serverd 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 tt_file_netfile(3) and
tt_host_file_netfile(3).
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 data-
bases 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.
rpc.ttdbserverd is invoked by inetd(8) when a rpc request is received,
under the smf(7) service identifier:
svc:/network/rpc/cde-ttdbserver
Common startup options can be set using the properties described in the
SMF PROPERTIES section below.
OPTIONS
-G Perform garbage collection. This cleans up the TT_DB directo-
ries 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.
-S Runs rpc.ttdbserverd in the foreground.
-n Turn off permission checking. Normally the protection of the
file passed to tt_spec_create(3) 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 tt_host_net-
file_file(3) queries. This environment variable can also be set
by using the -m flag for rpc.ttdbserverd.
TT_PARTITION_MAP
If $TT_PARTITION_MAP is set, it is used in place of /etc/tt/par-
tition_map. See partition_map(4).
SMF PROPERTIES
Configuration properties for the rpc.ttdbserverd program are managed by
the service management facility, smf(7), under the service identifier:
svc:/network/rpc/cde-ttdbserver
Administrative actions on this service, such as enabling, disabling, or
requesting restart, can be performed using svcadm(8). Responsibility
for initiating and restarting this service is delegated to inetd(8).
Use inetadm(8) to make configuration changes and to view configuration
information for this service. The service's status can be queried using
the svcs(1) command.
These properties can be configured on the instance of rpc.ttdbserverd:
ttdbserverd/gc
(Type boolean) Setting this to true performs garbage collection.
The default value is false.
ttdbserverd/permchk
(Type boolean) Setting this to true enables permission checking.
The default value is false.
ttdbserverd/mountpoint
(Type astring) Setting the DTMOUNTPOINT environment variable for
rpc.ttdbserverd. The default value for this property is "".
inetd/proto
(Type astring) Specify the TLI nettype to accept connections on.
This SMF property is used to allow or disallow access over the
network. proto="ticotsord" restricts access to clients on the
same host using the ticotsord(4d) loopback transport provider.
proto="tcp" allows access to clients on other hosts over the
tcp(4p) network protocol. The default value is "ticotsord".
EXAMPLES
Example 1: Viewing inetd service properties
The following command displays the inetd properties of the ttdbserver
service.
inetadm -l svc:/network/rpc/cde-ttdbserver:tcp
Example 2: Allow remote access
The following command allows access from clients across the network.
inetadm -m svc:/network/rpc/cde-ttdbserver:tcp proto="tcp"
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).
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+------------------+
|Availability | library/tooltalk |
+---------------+------------------+
|Stability | Committed |
+---------------+------------------+
SEE ALSO
ttsession(1), tt_file_netfile(3), tt_host_file_netfile(3), tt_spec_cre-
ate(3), hostname_map(4), partition_map(4), inetd(8), inetadm(8),
smf(7), svcs(8), ticotsord(4D), tcp(4P).
ToolTalk 1.3 11 Jun 2018 ttdbserver(8)