Go to main content

man pages section 8: System Administration Commands

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

ttdbserver (8)

Name

ttdbserver - based ToolTalk database server

Synopsis

rpc.ttdbserverd [-G] [-m DTMOUNTPOINT_value] [-n] [-v] [-?]

Description

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)