aboutsummaryrefslogtreecommitdiff
path: root/doc/pies.texi
diff options
context:
space:
mode:
Diffstat (limited to 'doc/pies.texi')
-rw-r--r--doc/pies.texi113
1 files changed, 82 insertions, 31 deletions
diff --git a/doc/pies.texi b/doc/pies.texi
index 96cbfb5..e21ea62 100644
--- a/doc/pies.texi
+++ b/doc/pies.texi
@@ -314,3 +314,3 @@ directives any time by running @command{pies --config-help}.
There are three classes of lexical tokens: keywords, values, and
-separators. Blanks, tabs, newlines and comments, collectively called
+separators. Blanks, tabs, newlines and comments, collectively called
@dfn{white space} are ignored except as they serve to separate
@@ -651,12 +651,12 @@ meaning as @samp{wait} in @file{inetd.conf} file, i.e. it tells
@command{pies} to wait for the server program to
-return. @FIXME-xref{inetd}.
+return. @FIXME-xref{inetd}.
@item tcpmux
-This is a @acronym{TCPMUX} component. @FIXME-xref{tcpmux}.
+This is a @acronym{TCPMUX} component. @xref{TCPMUX}.
@item tcpmuxplus
-This is a @acronym{TCPMUX+} component. @FIXME-xref{tcpmux}.
+This is a @acronym{TCPMUX+} component. @xref{TCPMUX}.
@item internal
-This is an internal inetd component. @FIXME-xref{internal inetd}.
+This is an internal inetd component. @xref{builtin}.
@@ -664,3 +664,3 @@ This is an internal inetd component. @FIXME-xref{internal inetd}.
This inetd component wants socket description variables in its
-environment. @FIXME-xref{sockenv}.
+environment. @FIXME-xref{sockenv}.
@@ -833,2 +833,7 @@ before assignment.
+@deffn {Config: component} max-instances @var{n}
+Sets the maximum number of simultaneously running instances of this
+component.
+@end deffn
+
@node Actions Before Startup
@@ -1025,15 +1030,19 @@ Define a socket to listen on. Allowed values for @var{url} are:
@table @asis
-@item file name
-Specifies a @acronym{UNIX} socket file name. You may use a relative
-file name, provided that @code{chdir} statement is used for this
-component (@pxref{Actions Before Startup, chdir}).
-
-@item local://@var{file}[;@var{args}]
-@itemx file://@var{file}[;@var{args}]
-@itemx unix://@var{file}[;@var{args}]
+@flindex /etc/protocols
+@item inet[+@var{proto}]://@var{ip}:@var{port}
+Listen on IPv4@footnote{Support for IPv6 will be added in future
+versions.}. address @var{ip} (may be given as a symbolic host name),
+on port @var{port}. Optional @var{proto} defines the protocol
+to use. It must be a valid protocol name as given in
+@file{/etc/protocols}. Default is @samp{tcp}.
+
+@item local[+@var{proto}]://@var{file}[;@var{args}]
+@itemx file[+@var{proto}]://@var{file}[;@var{args}]
+@itemx unix[+@var{proto}]://@var{file}[;@var{args}]
Listen on the @acronym{UNIX} socket file @var{file}, which is either
-an absolute or relative file name, as described above. Optional
-arguments @var{args} control ownership and file mode of @var{file}. They
-are a list of assignments, separated by semicolons. The following
-values are allowed:
+an absolute or relative file name, as described above. The
+@var{proto} part is as described above. Optional arguments, @var{args},
+control ownership and file mode of @var{file}. They are a list of
+assignments, separated by semicolons. The following values are
+allowed:
@@ -1060,11 +1069,53 @@ socket "unix:/var/run/socket;user=nobody;group=mail;mode=770";
-@item inet://@var{ip}:@var{port}
-Listen on IPv4 address @var{ip} (may be given as a symbolic host name),
-on port @var{port}.
+@item file name
+Specifies a @acronym{UNIX} socket file name. It is a shortcut for
+@samp{unix:@var{file-name}}. You may use a relative file name,
+provided that @code{chdir} statement is used for this component
+(@pxref{Actions Before Startup, chdir}).
@end table
+@end deffn
+
+@deffn {Config: component} socket-type @var{type}
+Sets the socket type. Allowed values for @var{type} are:
+@samp{stream}, @samp{dgram}, @samp{raw}, @samp{rdm},
+@samp{seqpacket}. Default is @samp{stream}. Notice that
+some socket types may not be implemented by all protocol
+families, e.g. @samp{seqpacket} is not implemented for
+@samp{inet}.
+@end deffn
+
+@anchor{max-rate}
+@deffn {Config: component} max-rate @var{n}
+Specifies the maximum number of times the component can be invoked in
+one minute; the default is unlimited. A rate of @samp{0} stands for
+@samp{unlimited}.
+@end deffn
+
+@deffn {Config: component} max-instances @var{n}
+Sets the maximum number of simultaneously running instances of this
+component. It is equivalent to the maximum number of simultaneously
+opened connections.
+@end deffn
+
+@menu
+* builtin:: Built-in Inetd Services
+* TCPMUX:: TCPMUX Services
+@end menu
+
+@node builtin
+@subsubsection Built-in Inetd Services
+@cindex builtin services
+@WRITEME
+
+@node TCPMUX
+@subsubsection TCPMUX Services
+@cindex TCPMUX
+@UNREVISED
+
+@deffn {Config: component} service @var{name}
+Sets the name of the service for TCPMUX sub-services.
+@end deffn
-Notice, that @command{pies} version @value{VERSION} handles only
-@acronym{TCP} sockets and only IPv4 addresses. Support for IPv6 will
-be added in future versions. Support for @acronym{UDP} sockets will
-be added if there is a demand.
+@deffn {Config: component} tcpmux-master @var{name}
+Sets the name of the master TCPMUX service.
@end deffn
@@ -1740,3 +1791,3 @@ return-code (EX_USAGE, EX_CONFIG) @{
which means it encountered some configuration problem.
- I will not restart it automatically. Please fix its configuration
+ I will not restart it automatically. Please fix its configuration
and restart it manually at your earliest convenience.
@@ -1964,3 +2015,3 @@ Display a short usage summary and exit.
@itemx -i
-Run in @command{inetd}-compatibility mode. It is roughly
+Run in @command{inetd}-compatibility mode. It is roughly
equivalent to @command{pies --instance=inetd --syntax=inetd}.
@@ -2002,9 +2053,9 @@ for @var{type} are:
@item pies
-Native @command{pies} configuration. @xref{Pies Configuration File}.
+Native @command{pies} configuration. @xref{Pies Configuration File}.
@item inetd
-@samp{Inetd}-style configuration files. @FIXME-xref{inetd}.
+@samp{Inetd}-style configuration files. @FIXME-xref{inetd}.
@item meta1
-@samp{meta1}-style configuration files. @FIXME-xref{meta1}.
+@samp{meta1}-style configuration files. @FIXME-xref{meta1}.
@end table
@@ -2020,3 +2071,3 @@ Log to syslog. This is the default.
Set maximum connection rate (connections per second) for inetd-style
-components. @FIXME-xref{inetd rate}.
+components. @xref{max-rate,, inetd component rate}.

Return to:

Send suggestions and report system problems to the System administrator.