ACE/debian/ace_netsvcs.sgml

   1 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
   2   <!ENTITY applname "ace_netsvcs">
   3   <!ENTITY seealso "/usr/share/ace-netsvcs/svc.conf, /usr/share/doc/ace-netsvcs/ACE-netsvcs.html">
   4 ]>
   5 <!-- This file was written by Marek Brudka <mbrudka@aster.pl>   -->
   6 <!-- on September 2010 for the Debian GNU/Linux operating system.             -->
   7 <!-- It is mainly a plain text to DocBook conversion of the USAGE file. -->
   8
   9 <refentry>
  10   <refmeta>
  11     <refentrytitle>ACE_NETSVCS</refentrytitle>
  12     <manvolnum>1</manvolnum>
  13   </refmeta>
  14   <refnamediv>
  15     <refname>&applname;</refname>
  16     <refpurpose>ACE network services driver.</refpurpose>
  17   </refnamediv>
  18   <refsynopsisdiv>
  19     <title>SYNOPSIS</title>
  20     <cmdsynopsis>
  21       <command>&applname;</command>
  22       <arg rep="repeat"><replaceable>OPTION</replaceable></arg>
  23     </cmdsynopsis>
  24   </refsynopsisdiv>
  25   <refsect1>
  26     <title>DESCRIPTION</title>
  27     <para>
  28       &applname; is a driver to start ACE network services. Currently,
  29       libnetsvcs provides: Naming Service, Time Service, Token Service,
  30       Server Logging Service, Client Logging Service, Logging Strategy Service.
  31     </para>
  32   </refsect1>
  33   <refsect1>
  34     <title>OPTIONS</title>
  35       <variablelist>
  36       <varlistentry>
  37         <term><parameter>-f</parameter> <replaceable>svc.conf</replaceable> </term>
  38         <listitem>
  39           <para>
  40             Specifies a <replaceable>svc.conf</replaceable> configuration file name other
  41             than the default one. Can be specified multiple times to use multiple files.
  42           </para>
  43         </listitem>
  44         </varlistentry>
  45         <varlistentry>
  46         <term><parameter>-d</parameter></term>
  47         <listitem>
  48           <para>
  49             Turn on debugging mode.
  50           </para>
  51         </listitem>
  52         </varlistentry>
  53         <varlistentry>
  54         <term><parameter>-n</parameter></term>
  55         <listitem>
  56           <para>
  57             Explicitly disables the use of static services. This flag overrides the @a ignore_static_svcs parameter value.
  58           </para>
  59         </listitem>
  60         </varlistentry>
  61         <varlistentry>
  62         <term><parameter>-p</parameter> <replaceable>pathname</replaceable></term>
  63         <listitem>
  64           <para>
  65             Specifies a <replaceable>pathname</replaceable> which is used to store the process id.
  66           </para>
  67         </listitem>
  68         </varlistentry>
  69         <varlistentry>
  70         <term><parameter>-s</parameter> <replaceable>signal</replaceable></term>
  71         <listitem>
  72           <para>
  73             Specifies a <replaceable>signal</replaceable> number other than SIGHUP to trigger
  74             reprocessing of the configuration file(s). Ignored for platforms that do not have
  75             POSIX signals, such as Windows.
  76           </para>
  77         </listitem>
  78         </varlistentry>
  79         <varlistentry>
  80         <term><parameter>-y</parameter></term>
  81         <listitem>
  82           <para>
  83             Explicitly enables the use of static services. This flag
  84             overrides the @a ignore_static_svcs parameter value.
  85           </para>
  86         </listitem>
  87         </varlistentry>
  88         <varlistentry>
  89         <term><parameter>-S</parameter> <replaceable>directive</replaceable></term>
  90         <listitem>
  91           <para>
  92             Specifies a service <replaceable>directive</replaceable> string.
  93             Enclose the string in quotes
  94             and escape any embedded quotes with a backslash. This option
  95             specifies service directives without the need for a configuration
  96             file.
  97           </para>
  98         </listitem>
  99         </varlistentry>
 100         <varlistentry>
 101         <term><parameter>-b</parameter></term>
 102         <listitem>
 103           <para>
 104             Option to indicate that we should be a daemon. Note that when
 105             this option is used, the process will be daemonized before the
 106             service configuration file(s) are read. During daemonization,
 107             (on POSIX systems) the current directory will be changed to "/"
 108             so the caller should either fully specify the file names, or
 109             execute a @c chroot() to the appropriate directory.
 110             @sa ACE::daemonize().
 111           </para>
 112         </listitem>
 113         </varlistentry>
 114         <varlistentry>
 115         <term><parameter>-k</parameter> <replaceable>point</replaceable></term>
 116         <listitem>
 117           <para>
 118             Specifies the rendezvous <replaceable>point</replaceable> to use for the ACE distributed
 119             logger.
 120           </para>
 121         </listitem>
 122         </varlistentry>
 123        </variablelist>
 124   </refsect1>
 125   <refsect1>
 126     <title>EXAMPLES</title>
 127       <variablelist>
 128       <varlistentry>
 129         <term><code>&applname; -f /usr/share/ace-netsvcs/svc.conf</code></term>
 130         <listitem>
 131           <para>
 132             Starts ACE network services using example configuration.
 133           </para>
 134         </listitem>
 135         </varlistentry>
 136       <varlistentry>
 137         <term><code>&applname; -S &#39;dynamic Name_Server Service_Object * netsvcs:_make_ACE_Name_Acceptor() ""-p 20006""&#39; </code></term>
 138         <listitem>
 139           <para>
 140             Starts ACE Naming service using command line configuration.
 141           </para>
 142         </listitem>
 143         </varlistentry>
 144
 145
 146       </variablelist>
 147   </refsect1>
 148   <refsect1>
 149     <title>SEE ALSO</title>
 150     <para>&seealso;</para>
 151   </refsect1>
 152   <refsect1>
 153     <title>AUTHOR</title>
 154     <para>Douglas C. Schmidt<email>&lt;schmidt@cs.wustl.edu&gt;</email> </para>
 155   </refsect1>
 156 </refentry>
 157
 158