.\" $Id: acctmux.man,v 1.2 2013/09/02 14:37:31 ksb Exp $
.\" by KS Braunsdorf
.\" $Compile: Display%h
.\" $Display: ${groff:-groff} -Tascii -man %f |${PAGER:-less}
.\" $Display(*): ${groff:-groff} -T%s -man %f
.\" $Install: %b -mDeinstall %o %f && cp %f $DESTDIR${TOP:-/usr/local}/man/man7/acctmux.7
.\" $Deinstall: ${rm-rm} -f $DESTDIR${TOP:-/usr/local}/man/man8/acctmux.7*
.TH ACCTMUX 7 LOCAL
.SH NAME
acctmux - collect files via tcpmux call-back service and op support
.SH SYNOPSIS
.ds PN "acctmux
\fI\*(PN\fP [\fB\-dMx\fP] [\fIenv\fP=\fIvalues\fP]
.br
\fI\*(PN\fP \fB\-h\fP
.br
\fI\*(PN\fP \fB\-V\fP


.SH DESCRIPTION
This program is almost never run from the command-line; it is run from
\fBtcpmux\fP(8l) when a custom \fBop\fP rule triggers the collection of
a client's file.
.P
Mortal users submit custom files to populate new home directories
via an \fIop\fP(1l) rule, with help from this \fBtcpmux\fP service.
The accounting system owner \fIacct\fP provides this service via the
\fIop\fP rule \fBacct submit\fP, which is configured according to
local site policy.
.P
By default it collects the clients \f(BC.ssh/authorized_keys\fP file.
The rule should be run from your home directory.  If you run it from
another directory, then it will look for that same relative path;
this may be handy to submit test files.
.P
.\" local site policy (op rule name) below
The rule \fBacct authkey\fP creates an authorization stamp which
allows the accounting login to effectively \fIscp\fP the requested files from
your account.  The process then invalidates the stamp, so no
additional copies are possible, until you re-authorized the service.
.P
There may be a way to ask your local accounting system to confirm the
size and date of the cached files.  There may be a way to
ask the local accounting system to update a set of hosts.
These are a matter of local site policy.

.SH OPTIONS
This scipt is meant to be augmented before installation. Local policy may
add options to the script, however these are the base options.
.TP
.nf
\fB\-d\fP
.fi
Allow hosts without reverse IP to submit files.
.TP
.nf
\fB\-h\fP
.fi
Output only a helpful usage message.
.TP
.nf
\fB\-M\fP
.fi
Mask network replies to deny protocol clues.
.TP
.nf
\fB\-V\fP
.fi
Show only version information.
.TP
.nf
\fB\-x\fP
.fi
Trace client submissions on \fIstderr\fP, which is only useful when
debugging the script from the command-line,.
.SH PROTOCOL
The chat protocol between the \fBmuxsend\fP(1l) \fI\*(PN\fP is
not really public.  But it is a \fBperl\fP(1) program, so you could
just read the code.  Local policy may extend the protocol across
specifiv clusters, for example.

.SH AUTHOR
KS Braunsdorf
.br
NonPlayer Character Guild
.br
stamps at ksb dot npcguild.org

.SH "HTML"
See jacket.html in the source to op's jackets.

.SH "SEE ALSO"
.hlm 0
op(1l), stampctl(8), stamp(7), ssh(1), op-jacket(7l), muxsend(1l),
msrcmux(7l)