aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/pies.texi28
1 files changed, 18 insertions, 10 deletions
diff --git a/doc/pies.texi b/doc/pies.texi
index 04c85a4..b6f2c91 100644
--- a/doc/pies.texi
+++ b/doc/pies.texi
@@ -274,15 +274,15 @@ the end of the command line or the next occurrence of the
@option{--syntax} option. This means that you can instruct
@command{pies} to read several configuration files of various formats
in a single command line, e.g.:
@smallexample
@group
-pies /etc/pies.conf \
- --syntax=inetd --config-file /etc/inetd.conf \
- --syntax=meta1 --config-file /etc/meta1/meta1.conf
+pies --config-file /etc/pies.conf \
+ --syntax=inetd --config-file /etc/inetd.conf \
+ --syntax=meta1 --config-file /etc/meta1/meta1.conf
@end group
@end smallexample
@xopindex{config-help, introduced}
The rest of this chapter concerns the @command{pies} native
configuration file format. You can receive a concise summary of all
@@ -2048,17 +2048,24 @@ Retain all supplementary groups the user (as given with
start @command{jabberd} components:
@uref{http://www.gnu.org.ua/@/software/@/pies/@/example.php?what=jabberd2}.
@node State Files
@section State Files
@cindex state files
- Pies uses several files to keep its state information. These files
-are kept in local state directory (usually @file{/var/run/pies}, or
-@file{/usr/local/var/run/pies}). The table below describes these
-files. The @var{instance} in this table stands for the @command{pies}
-instance name (@pxref{instances}). Usually, it is @samp{pies}.
+ Pies uses several files to keep its state information. The
+directory which hosts these files is called @dfn{state directory}, it
+is usually @file{/var/pies} or @file{/usr/local/var/pies}). The state
+directory can be configured at run time:
+
+@deffn {Config} state-directory @var{dir}
+Set the program state directory.
+@end deffn
+
+The table below describes the files kept in the state directory. The
+@var{instance} in this table stands for the @command{pies} instance
+name (@pxref{instances}). Usually, it is @samp{pies}.
@table @asis
@item @file{@var{instance}.pid}
The @dfn{PID file}. It keeps the PID number of the running
@command{pies} instance.
@@ -2073,14 +2080,15 @@ The @dfn{statistics file}. Used by @command{pies --status}.
@item @file{@var{instance}.qotd}
The @dfn{Quotation-of-the-day file}. It is used by the @samp{qotd}
built-in service (@pxref{qotd}).
@end table
The following statements allow to redefine state file names.
-Use them only if the defaults does not suit your needs, and the
-@option{--instance} option does not help:
+Use them only if the defaults do not suit your needs, and niether
+the @code{state-directory} statement nor the @option{--instance}
+can help:
@deffn {Config} pidfile @var{file}
Sets the PID file name.
@end deffn
@deffn {Config} control-file @var{file}

Return to:

Send suggestions and report system problems to the System administrator.