.\" Copyright (C) 1999-2002 Cameron Moore and others
.\"
.\" 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
.\" Or try here: http://www.fsf.org/copyleft/gpl.html
.\"
.\" $Id: away.1,v 1.3 2002/08/23 03:43:46 hrothgar Exp $
.\"
.TH away 1 "November 2000" Linux "User Manuals"
.SH NAME
away \- terminal locking program
.SH SYNOPSIS
.B away [OPTIONS]
.I message
.B [...]
.SH DESCRIPTION
.B away
is a simple program that locks your terminal, checks for new mail
in any given number of mailboxes, and lets other users know why
you are inactive.
.SH OPTIONS
.IP "-c, --mail"
Enable checking of mail.
.IP "-C, --nomail"
Disable checking of mail.
.IP "-f, --rcfile=FILE"
Specify an alternative configuration file instead of the default
~/.awayrc file.
.IP "-F, --norcfile"
Ignore user configuration file.
.IP "-h, --help"
Display help.
.IP "-m, --message"
Execute as the remainder of the command line, effectively stripping
off the executable name and additional switches.
.IP "-p, --persist"
Continue checking for new mail as long as there is at least one mailbox
that has not received new mail.
.IP "-P, --nopersist"
Stop checking mail if any mailbox is found to have new mail.
.IP "-t, --time=SECONDS"
Set the number of second that away sleeps before performing its
background tasks.  Presently, the only background task that away will
perform is the checking of mailboxes.
.IP "-T, --notime"
Ignore any options to set the time interval and use the default number
of seconds.
.IP "-v, --version"
Display version information.
.SH FILES
.I ~/.awayrc
.RS
Per user configuration file. See
.BR awayrc (5)
for further details.
.RE

.I /etc/pam.d/away
.RS
The
.B Linux-PAM
configuration file.
.RE
.SH BUGS
Bug reports should be sent to the away mailing list
<away@unbeatenpath.net>.
.SH SEE ALSO
.BR awayrc (5)
.SH AUTHORS
Cameron Moore <cameron@unbeatenpath.net>, and others.