summaryrefslogtreecommitdiff
path: root/ACE/debian/ace_netsvcs.sgml
blob: 910c02c68e2efa63fae49eea5dc9af41e3ee6bc0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
  <!ENTITY applname "ace_netsvcs">
  <!ENTITY seealso "/usr/share/ace-netsvcs/svc.conf, /usr/share/doc/ace-netsvcs/ACE-netsvcs.html">
]>
<!-- This file was written by Marek Brudka <mbrudka@aster.pl>   -->
<!-- on September 2010 for the Debian GNU/Linux operating system.             -->
<!-- It is mainly a plain text to DocBook conversion of the USAGE file. -->

<refentry>
  <refmeta>
    <refentrytitle>ACE_NETSVCS</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>
  <refnamediv>
    <refname>&applname;</refname>
    <refpurpose>ACE network services driver.</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <title>SYNOPSIS</title>
    <cmdsynopsis>
      <command>&applname;</command>
      <arg rep="repeat"><replaceable>OPTION</replaceable></arg>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>
    <para>
      &applname; is a driver to start ACE network services. Currently, 
      libnetsvcs provides: Naming Service, Time Service, Token Service,  
      Server Logging Service, Client Logging Service, Logging Strategy Service.
    </para>
  </refsect1>
  <refsect1>
    <title>OPTIONS</title>
      <variablelist>
      <varlistentry>
	<term><parameter>-f</parameter> <replaceable>svc.conf</replaceable> </term>
	<listitem>
	  <para>
	    Specifies a <replaceable>svc.conf</replaceable> configuration file name other 
	    than the default one. Can be specified multiple times to use multiple files.
	  </para>
	</listitem>
	</varlistentry>
	<varlistentry>
	<term><parameter>-d</parameter></term>
	<listitem>
	  <para>
	    Turn on debugging mode.
	  </para>
	</listitem>
	</varlistentry>
	<varlistentry>
	<term><parameter>-n</parameter></term>
	<listitem>
	  <para>
	    Explicitly disables the use of static services. This flag overrides the @a ignore_static_svcs parameter value.
	  </para>
	</listitem>
	</varlistentry>
	<varlistentry>
	<term><parameter>-p</parameter> <replaceable>pathname</replaceable></term>
	<listitem>
	  <para>
	    Specifies a <replaceable>pathname</replaceable> which is used to store the process id.
	  </para>
	</listitem>
	</varlistentry>
	<varlistentry>
	<term><parameter>-s</parameter> <replaceable>signal</replaceable></term>
	<listitem>
	  <para>
	    Specifies a <replaceable>signal</replaceable> number other than SIGHUP to trigger 
	    reprocessing of the configuration file(s). Ignored for platforms that do not have 
	    POSIX signals, such as Windows.	  
	  </para>
	</listitem>
	</varlistentry>
	<varlistentry>
	<term><parameter>-y</parameter></term>
	<listitem>
	  <para>
	    Explicitly enables the use of static services. This flag
	    overrides the @a ignore_static_svcs parameter value.
	  </para>
	</listitem>
	</varlistentry>
	<varlistentry>
	<term><parameter>-S</parameter> <replaceable>directive</replaceable></term>
	<listitem>
	  <para>
	    Specifies a service <replaceable>directive</replaceable> string. 
	    Enclose the string in quotes
	    and escape any embedded quotes with a backslash. This option
	    specifies service directives without the need for a configuration
	    file.	  
	  </para>
	</listitem>
	</varlistentry>
	<varlistentry>
	<term><parameter>-b</parameter></term>
	<listitem>
	  <para>
	    Option to indicate that we should be a daemon. Note that when
	    this option is used, the process will be daemonized before the
	    service configuration file(s) are read. During daemonization,
	    (on POSIX systems) the current directory will be changed to "/"
	    so the caller should either fully specify the file names, or
	    execute a @c chroot() to the appropriate directory.
	    @sa ACE::daemonize().	  
	  </para>
	</listitem>
	</varlistentry>      
	<varlistentry>
	<term><parameter>-k</parameter> <replaceable>point</replaceable></term>
	<listitem>
	  <para>
	    Specifies the rendezvous <replaceable>point</replaceable> to use for the ACE distributed
	    logger.
	  </para>
	</listitem>
	</varlistentry>      
       </variablelist>
  </refsect1>
  <refsect1>
    <title>EXAMPLES</title>
      <variablelist>
      <varlistentry>
	<term><code>&applname; -f /usr/share/ace-netsvcs/svc.conf</code></term>
	<listitem>
	  <para>
	    Starts ACE network services using example configuration.
	  </para>
	</listitem>
	</varlistentry>
      <varlistentry>
	<term><code>&applname; -S &#39;dynamic Name_Server Service_Object * netsvcs:_make_ACE_Name_Acceptor() ""-p 20006""&#39; </code></term>
	<listitem>
	  <para>
	    Starts ACE Naming service using command line configuration.
	  </para>
	</listitem>
	</varlistentry>


      </variablelist>
  </refsect1>
  <refsect1>
    <title>SEE ALSO</title>
    <para>&seealso;</para>
  </refsect1>
  <refsect1>
    <title>AUTHOR</title>
    <para>Douglas C. Schmidt<email>&lt;schmidt@cs.wustl.edu&gt;</email> </para>
  </refsect1>
</refentry>