diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/pies.texi | 28 |
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} |