rpc.ttdbserverd - 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)