head	1.9;
access;
symbols;
locks; strict;
comment	@# @;


1.9
date	99.04.28.11.03.37;	author alexis;	state Exp;
branches;
next	1.8;

1.8
date	99.01.15.13.15.07;	author alexis;	state Exp;
branches;
next	1.7;

1.7
date	99.01.07.13.24.36;	author alexis;	state Exp;
branches;
next	1.6;

1.6
date	98.10.07.16.52.42;	author alexis;	state Exp;
branches;
next	1.5;

1.5
date	98.08.28.14.02.08;	author alexis;	state Exp;
branches;
next	1.4;

1.4
date	98.08.28.13.54.13;	author alexis;	state Exp;
branches;
next	;


desc
@SHPP PORT AND RE-SECTIONING sndmsg.8.in 1.3
@


1.9
log
@changed explicit message id numbers for shpp variables
@
text
@.\"    $Header: /diskb/home/alexis/dev/supported/ppplc/man/RCS/sndmsg.1.shpp,v 1.8 1999/01/15 13:15:07 alexis Exp alexis $
.\"
#shpp include ../bin/sm_msgids.shpp
#shpp include ../bin/ppplc_msgids.shpp
.PP
.TH SNDMSG 1 "15 January 1999"
.SH NAME
Sndmsg \- PPP Link Control Message Sender
.br
.\"
.\" we don't need a .br/.ne 5 here since there
.\" isn't any chance really, that we're already
.\" anywhere near the end of the first page.
.\"
.SH SYNOPSIS
.B sndmsg
[
.B \-v
|
.B \-d
.I level
] [
.B \-q
.I delay
] [
.B \-t 
.I recipient
]
.I msgid 
[
.I msgpars
] ...
.br
.B "sndmsg -V"
.br
.\"
.\" we don't need a .br/.ne 5 here since there
.\" isn't any chance really, that we're already
.\" anywhere near the end of the first page.
.\"
.SH DESCRIPTION
This man page documents 
.I sndmsg
version MARKER_PATCHLEVEL.
.PP
.I Sndmsg
is a lightweight program to send messages to a message queue read by
.I ppplcd\fR(8). 
It is primarily for use in scripts, such as
.I ppplcc\fR(1),
.I qtest\fR(UNDOCUMENTED),
.I usecnt\fR(UNDOCUMENTED)
as well as in cron jobs (see 
.I cron\fR(8)),
user startup scripts.
.PP
Message ids are numeric. Certain message ids require a fixed number of
parameters. Currently only integer parameters are supported. Currently two
programs read the messages dispatched by 
.I sndmsg\fR:
.I ppplcd\fR(8)
and
.I getmsg\fR(UNDOCUMENTED). 
This page only documents messages useful to end-users.
There are many more internally used messages. For information on those, please
refer to the C sources.
.br
.ne 5
.SH OPTIONS
.\"  This indents everything after the next line by 25 somethings.
.TP 25
.B \-V
Print the version number and exit.
.TP
.B \-v
Sets the verbosity level to include errors, warnings and informational
mesaages.
.TP
.B \-d \fIlevel
Sets the verbosity level to 
.I level\fR.
Each binary bit in 
.I level
turns on a different debugging facility. This option is not intended for
end-users. The various bits and their meanings change regularly. For
more information see the proram C sources.
.TP
.B \-q \fIdelay
Instead of the message being acted upon immediately, the messages are
only queued immediately, but only processed after the specified delay
in seconds.
.TP
.B \-t \fIrecipient
By default messages are marked for the attention of 
.I ppplcd\fR(8)\fR,
but they may be marked for the attention of other programs which know how
to read the message queue. This feature is currently not for end-users.
.PD
.PP 
The following messages are currently supported. This list is very
dynamic, so upgrading this program may break any locally written 
scripts. Beware!
.TP 25
.B MARKER_MSGID_EXEC_PPPD
Call 
.I pppd\fR(8)
to connect.
.TP
.B MARKER_MSGID_SET_QUIT
Instruct 
.I ppplcd\fR(8)
to exit.
.TP
.B MARKER_MSGID_HANGUP
Kill any currently running
.I pppd\fR(8),
closing the connection if there is one.
If 
.I pppd\fR(8)
is in an uninterruptable state, then it will be killed at the 
earliest opportunity.
.TP
.B MARKER_MSGID_NOACTION
Do nothing.
.TP
.B MARKER_MSGID_SET_IDLEPARS \fIidletimeout
Set the idle timeout to the specified value in seconds. 0 indicates no
idle timeout, although beware that changing this value will not reset
any idle timeout set at the remote end of the connection, nor will it
regenerate the chatscript.
.TP
.B MARKER_MSGID_EXEC_ANNOUNCE \fIannouncementid
Instruct 
.I ppplcd\fR(8)
to call the announcement program (specified in its config file), with 
the parameter
.I announcementid\fR.
.TP
.B MARKER_MSGID_SET_QUALITY \fIminquality checkinterval
Sets the minimum acceptable quality to 
.I minquality
and the interval at which quality checks are made to
.I checkinterval\fR.
If as a result of sending this message, either argument is now zero, then
quality checking ceases. Similarly if both arguments are now non-zero, then
quality checking is initiated. Beware that depending on the script used to
perform quality checking, quality checking may constitute use of the link
and as such interfere with idle timeouts.
.TP
.B MARKER_MSGID_INFO_REQ \fIrecipient
Requests information about the value of many internal variables. The information
is marked for the attention of 
.I recipient\fR.
This information is intended to be read with 
.I getmsg\fR(UNDOCUMENTED),
which will sooner or later be used by both
.I ppplcc\fR(1) 
and 
.I xppplcc\fR(1).
.TP
.B MARKER_MSGID_SET_DONEWS
Enable post-connect-time news transfer.
.TP
.B MARKER_MSGID_EXEC_MISC
Perform miscellanous commands, as specified in config file.
.TP
.B MARKER_MSGID_UNSET_DONEWS
Disable post-connect-time news transfer.
.TP
.B MARKER_MSGID_SET_DEBUG \fIlevel
set debugging level to 
.I level\fR.
.TP 
.B MARKER_MSGID_SET_AUTORECONNECT
Enable autoreconnect. That is if the remote end hangs up, then the local
end will immediately attempt to reconnect.
.TP
.B MARKER_MSGID_UNSET_AUTORECONNECT
Disable autoreconnect. 
.TP
.B MARKER_MSGID_EXEC_MAIL
Perform mail transfer now.
.TP
.B MARKER_MSGID_EXEC_NEWS
Perform news transfer now.
.TP
.B MARKER_MSGID_DEL_MSGID \fImsgid
Delete any delayed messages of type 
.I msgid\fR.
.PD
.br
.ne 5
.SH EXAMPLES
.PP 
The following 
.I crontab\fR(1)
entries would instruct 
.I ppplcd\fR(8)
to call
.I pppd\fR(8)
to connect at 7.30 am each working day, and to disconnect 15 minutes later
if it hadn't already hung up:
.nf
.IP
30 7 * * 1-5 MARKER_LCLBINDIR/sndmsg MARKER_MSGID_EXEC_PPPD
45 7 * * 1-5 MARKER_LCLBINDIR/sndmsg MARKER_MSGID_HANGUP
.fi
.PP 
or alternatively:
.nf
.IP
30 7 * * 1-5 ( MARKER_LCLBINDIR/sndmsg MARKER_MSGID_EXEC_PPPD; MARKER_LCLBINDIR/sndmsg -q 900 MARKER_MSGID_HANGUP )
.fi
.br
.ne 5
.SH FILES
None.
.br
.ne 5
.SH ENVIRONENT VARIABLES
None.
.br 
.ne 5
.SH DIAGNOSTICS
Only diagnostic messages which are so cryptic that they need to be explained
are explained here.
.PD 0
.TP 25
.B sndmsg: ERROR: can't queue message (\fIerrno\fB)
This message should not appear! Please report it if you see it.
.TP
.B sndmsg: INTERNAL ERROR: failed to locate msgid \fImsgid\fB in table
Internally required information pertaining to the specified message id could
not be located. Did you use a message id not documented on this page?
.PD 
.br
.ne 5
.SH CAVEATS
None.
.br
.ne 5
.SH SEE ALSO
ppplcc(1), ppplcd(8), pppd(8), cron(8), crontab(1)
.br
.ne 5
.SH AUTHOR
Alexis Huxley
.br
.ne 5
.SH BUGS
No known bugs.
.PP
Bug reports and queries should be reported to
.B ppplc-support@@danae.demon.co.uk\fR.
.PP
For the latest release of
.I ppplc\fR,
visit
.B http://www.danae.demon.co.uk/software/ppplc/\fR.
.br
.ne 5
.SH COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 1996-1999 Alexis Huxley
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
.PP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
@


1.8
log
@bumped date
@
text
@d1 1
a1 1
.\"    $Header: /diskb/home/alexis/dev/supported/ppplc/man/RCS/sndmsg.1.shpp,v 1.7 1999/01/07 13:24:36 alexis Exp alexis $
d3 2
d104 1
a104 1
.B 0
d109 1
a109 1
.B 3
d114 1
a114 1
.B 5
d123 1
a123 1
.B 24
d126 1
a126 1
.B 25 \fIidletimeout
d132 1
a132 1
.B 26 \fIannouncementid
d139 1
a139 1
.B 27 \fIminquality checkinterval
d150 1
a150 1
.B 29 \fIrecipient
d156 1
a156 1
which will sooner or later be used by
d161 1
a161 1
.B 30
d164 1
a164 1
.B 32
d167 1
a167 1
.B 33
d170 1
a170 1
.B 35 \fIlevel
d174 1
a174 1
.B 37
d178 1
a178 1
.B 38
d181 1
a181 1
.B 41
d184 1
a184 1
.B 44
d187 1
a187 1
.B 48 \fImsgid
d205 2
a206 2
30 7 * * 1-5 MARKER_LCLBINDIR/sndmsg 0
45 7 * * 1-5 MARKER_LCLBINDIR/sndmsg 5
d212 1
a212 1
30 7 * * 1-5 ( MARKER_LCLBINDIR/sndmsg 0; MARKER_LCLBINDIR/sndmsg -q 900 5 )
d263 1
a263 1
Copyright (C) 1996-1998 Alexis Huxley
@


1.7
log
@corrections and symbol name changes
@
text
@d1 1
a1 1
.\"    $Header: sndmsg.1.shpp,v 1.6 1998/10/07 16:52:42 alexis Exp alexis $
d4 1
a4 1
.TH SNDMSG 1 "12 December 1998"
@


1.6
log
@wrote a proper man page at last
@
text
@d1 1
a1 20
.\"
.\"
.\"    SNDMSG.1 - Manual Page for 'sndmsg' Command
.\"    Copyright (C) 1996-1998 Alexis Huxley <alexis@@danae.demon.co.uk>
.\"
.\"    This program is free software; you can redistribute it and/or modify
.\"    it under the terms of the GNU General Public License as published by
.\"    the Free Software Foundation; either version 2 of the License, or
.\"    (at your option) any later version.
.\"
.\"    This program is distributed in the hope that it will be useful,
.\"    but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\"    GNU General Public License for more details.
.\"
.\"    You should have received a copy of the GNU General Public License
.\"    along with this program; if not, write to the Free Software
.\"    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
.\"
.\"    $Id: sndmsg.1.shpp,v 1.5 1998/08/28 14:02:08 alexis Exp alexis $
d4 1
a4 1
.TH SNDMSG 1 "8 September 1998"
d42 1
a42 1
version PATCHLEVEL_MARKER.
d45 2
a46 3
is a lightweight program to send messages to a message queue read primarily
by
.B ppplcd\fR(8). 
d48 3
a50 3
.B ppplcc\fR(1),
.B qtest\fR(UNDOCUMENTED),
.B usecnt\fR(UNDOCUMENTED)
d52 2
a53 2
.B cron\fR(8)),
user startup scripts, and window manager configuration files.
d56 4
a59 3
arguments. Currently only integer arguments are supported. Currently two
programs read messages; 
.B ppplcd\fR(8)
d61 2
a62 1
.B getmsg\fR(UNDOCUMENTED). This page documents messages useful to end-users.
d87 3
a89 2
Instead of the message being acted upon immediately, the messages is 
delayed by the specified amount of seconds.
d93 1
a93 1
.B ppplcd\fR(8)\fR,
a96 3
.br
.ne 5
.SH MESSAGES
d104 1
a104 1
.B pppd\fR(8)
d109 1
a109 1
.B ppplcd\fR(8)
d114 5
a118 2
.B pppd\fR(8).
If it is in an uninterruptable state, then it will be killed at the 
d127 2
a128 1
any idle timeout set at the remote end of the connection.
d132 1
a132 1
.B ppplcd\fR(8)
d153 1
a153 1
.B getmsg\fR(UNDOCUMENTED),
d155 1
a155 1
.B ppplcc\fR(1) 
d157 1
a157 1
.B xppplcc\fR(1).
d194 1
a194 1
.B crontab\fR(1)
d196 1
a196 1
.B ppplcd\fR(8)
d198 1
a198 1
.B pppd\fR(8)
d203 2
a204 2
30 7 * * 1-5 LCLBINDIR_MARKER/sndmsg 0
45 7 * * 1-5 LCLBINDIR_MARKER/sndmsg 5
d210 1
a210 1
30 7 * * 1-5 ( LCLBINDIR_MARKER/sndmsg 0; LCLBINDIR_MARKER/sndmsg -q 900 5 )
d223 2
d228 1
a228 1
This message should not appear! Please report it, if you see it.
d245 1
a245 5
Alexis Huxley <alexis@@danae.demon.co.uk>
.br
.ne 5
.SH STATUS
Quite changable.
d250 8
d261 1
a261 1
Copyright (C) 1996-1998 Alexis Huxley <alexis@@danae.demon.co.uk>
@


1.5
log
@added PATCHLEVEL_MARKER and RCS ID
also added that the page is out of date
@
text
@d3 2
a4 2
.\"    ???????.1 - Manual Page for ??????? Command
.\"    Copyright (C) 1996 Alexis Huxley <alexis@@danae.demon.co.uk>
d20 1
a20 1
.\"    $Id: sndmsg.1.shpp,v 1.4 1998/08/28 13:54:13 alexis Exp alexis $
d23 1
a23 5
This page is under development. If there is any information in it at
all, it is probably wrong. Please refer to the installation documentation
in PRGDOCDIR_MARKER.
.PP
.TH SNDMSG 1 "1 March 1998"
d25 1
a25 1
Sndmsg \- PPP Link Control Message Dispatcher
a32 2
.B "sndmsg -V"
.br
d39 13
a51 2
] 
.I msgid \fR\.\.\.
d64 2
a65 1
is a lightweight program to queue messages to 
d67 7
a73 4
It is primarily for use in scripts (such as
.B ppplcc\fR(1)
and in cron jobs (see
.B cron\fR(8)).
d75 3
a77 4
Message ids are numeric. Certain message ids require numeric arguments. 
Currently all messages are interpreted only by 
.B ppplcd\fR(8).
Message ids, their parameters and their interpretation by 
d79 4
a82 10
are listed below. 
.PP
.TP 25
.B 0
call pppd to connect
.TP
.B 1 \fIlevel
set debugging level to 
.I level
.PD
d92 2
a93 2
Sets the verbosity level to 3. (This is virtually meaningless, see below
for an explanation.)
d101 103
a203 1
end-users and is not documented here.
d208 2
a209 1
.PP The following 
d217 11
a227 3
.br
30 7 * * 1-5 LCLSBINDIR_MARKER/sndmsg 0
45 7 * * 1-5 LCLSBINDIR_MARKER/sndmsg 5
d241 6
a246 2
.B ???????: WARNING: ????
??????
d263 1
a263 1
Stable.
@


1.4
log
@*** empty log message ***
@
text
@d20 1
a20 1
.\"    $Id: sndmsg.8.in,v 1.3 1998/03/01 22:27:40 alexis Exp $
d22 5
@