.\"	$Id$
.\"
.\" HylaFAX Facsimile Software
.\"
.\" Copyright (c) 1994 Sam Leffler
.\" Copyright (c) 1994 Silicon Graphics, Inc.
.\" 
.\" Permission to use, copy, modify, distribute, and sell this software and 
.\" its documentation for any purpose is hereby granted without fee, provided
.\" that (i) the above copyright notices and this permission notice appear in
.\" all copies of the software and related documentation, and (ii) the names of
.\" Sam Leffler and Silicon Graphics may not be used in any advertising or
.\" publicity relating to the software without the specific, prior written
.\" permission of Sam Leffler and Silicon Graphics.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, 
.\" EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY 
.\" WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.  
.\" 
.\" IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR
.\" ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND,
.\" OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
.\" WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF 
.\" LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE 
.\" OF THIS SOFTWARE.
.\"
.if n .po 0
.ds Fx \fIHyla\s-1FAX\s+1\fP
.TH WEDGED 8 "October 3, 1995"
.SH NAME
wedged \- \*(Fx modem wedged script
.SH SYNOPSIS
.B /var/spool/hylafax/bin/wedged
.I devid
.I device
.SH DESCRIPTION
.B bin/wedged
is the command script invoked by the facsimile server when a modem
is deemed to be in an irreparable state and requires operator intervention.
This decision is based on the setting of the
.B MaxSetupAttempts
configuration parameter described in
.IR hylafax-config (5).
The default
.I wedged
script sends electronic mail to the FaxMaster alias. The interval at which
emails are sent can be configured in the
.B etc/FaxDispatch
file by setting the WEDGED_EMAIL_INTERVAL variable to the desired number
of minutes (emails will be sent no more than every WEDGED_EMAIL_INTERVAL
minutes, until the wedged condition persists).
If the variable WEDGED_DISABLE_FAXGETTY is set in
.B etc/FaxDispatch
then the script will attempt to disable any faxgetty processes spawned by the
.IR init (8)
process for the problematic modem.
In addition the
.IR faxq (8)
process automatically disables use of the modem for servicing
outbound jobs.
.P
The
.I devid
argument is the identifier derived from the name of the modem's
device file by substituting ``_'' characters for ``/'' characters;
e.g.
.I term_10
for
.IR /dev/term/10 .
The
.I device
argument is the name of the character special device
associated with the modem.
.P
If there exists an executable file 
.B /var/spool/hylafax/etc/resetmodem
then that file will be executed upon execution of
the
.I wedged
script in an effort to recover the modem.
.SH FILES
.nf
.ta \w'/usr/lib/sendmail    'u
/usr/lib/sendmail	for delivering mail
.fi
.SH "SEE ALSO"
.IR faxq (8),
.IR hylafax-config (5)