Sweep-fix man page section order to match mdoc(7), part 5/5.
[dragonfly.git] / usr.sbin / i4b / isdntel / isdntel.8
1 .\"
2 .\" Copyright (c) 1997, 1999 Hellmuth Michaelis. All rights reserved.
3 .\"
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
6 .\" are met:
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\"    notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\"    notice, this list of conditions and the following disclaimer in the
11 .\"    documentation and/or other materials provided with the distribution.
12 .\"
13 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16 .\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23 .\" SUCH DAMAGE.
24 .\"
25 .\"     last edit-date: [Mon Dec 13 23:05:59 1999]
26 .\"
27 .\" $FreeBSD: src/usr.sbin/i4b/isdntel/isdntel.8,v 1.9.2.5 2003/03/11 21:13:49 trhodes Exp $
28 .\" $DragonFly: src/usr.sbin/i4b/isdntel/isdntel.8,v 1.3 2006/02/17 19:40:15 swildner Exp $
29 .\"
30 .\"     $Id: isdntel.8,v 1.9 1999/12/13 22:11:55 hm Exp $
31 .\"
32 .Dd July 11, 1998
33 .Dt ISDNTEL 8
34 .Os
35 .Sh NAME
36 .Nm isdntel
37 .Nd isdn4bsd telephone answering management utility
38 .Sh SYNOPSIS
39 .Nm
40 .Op Fl a Ar aliasfile
41 .Op Fl d Ar spooldir
42 .Op Fl p Ar playcommand
43 .Op Fl t Ar timeout
44 .Sh DESCRIPTION
45 The
46 .Nm
47 utility is used to provide an "answering machine" functionality for incoming
48 telephone voice messages.
49 .Pp
50 The following options are supported:
51 .Bl -tag -width Ds
52 .It Fl a
53 Use
54 .Ar aliasfile
55 as the pathname for an aliasfile containing aliases for phone numbers. The
56 default path is
57 .Em /etc/isdn/isdntel.alias .
58 The format of an alias entry is the number string followed by one or more
59 spaces or tabs. The rest of the line is taken as the alias string. Comments
60 are introduced by a leading blank, tab or "#" character.
61 .It Fl d
62 Use
63 .Ar spooldir
64 as the directory where the incoming voice messages are stored by the
65 "answ" script called by
66 .Xr isdnd 8 .
67 This defaults to the directory
68 .Em /var/isdn .
69 The format of a voice message filename is:
70 .Pp
71 .Dl YYMMDDhhmmss-dest_number-source_number-length_in_secs
72 .It Fl p
73 Use
74 .Ar playcommand
75 as the command string to execute for playing a voice message to some audio
76 output facility. The characters
77 .Em %s
78 are replaced by the currently selected filename. The default string is
79 .Dq Li cat %s \&| alaw2ulaw >/dev/audio .
80 .It Fl t
81 The value for
82 .Ar timeout
83 specifies the time in seconds the program rereads the spool directory
84 when there is no keyboard activity.
85 .El
86 .Pp
87 The screen output should be obvious. If in doubt, consult the source.
88 .Sh SEE ALSO
89 .Xr i4btel 4 ,
90 .Xr isdnd.rc 5 ,
91 .Xr isdnd 8
92 .Sh AUTHORS
93 The
94 .Nm
95 utility and this manual page were written by
96 .An Hellmuth Michaelis Aq hm@kts.org .
97 .Sh BUGS
98 Still two or more left.