don't distribute compressed man pages,let the installer do it
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@6608 65c4cc65-6c06-0410-ace0-fbb531ad65f3
This commit is contained in:
parent
c4d824cf71
commit
509c285380
7
Makefile
7
Makefile
|
@ -399,13 +399,12 @@ testexpr2: ast_expr2f.c ast_expr2.c ast_expr2.h
|
|||
gcc -g -o testexpr2 ast_expr2f.o ast_expr2.o
|
||||
rm ast_expr2.c ast_expr2.o ast_expr2f.o ast_expr2f.c
|
||||
|
||||
manpage: asterisk.8.gz
|
||||
manpage: asterisk.8
|
||||
|
||||
asterisk.8.gz: asterisk.sgml
|
||||
asterisk.8: asterisk.sgml
|
||||
rm -f asterisk.8
|
||||
docbook2man asterisk.sgml
|
||||
mv ./*.8 asterisk.8
|
||||
gzip asterisk.8
|
||||
|
||||
asterisk.pdf: asterisk.sgml
|
||||
docbook2pdf asterisk.sgml
|
||||
|
@ -601,7 +600,7 @@ bininstall: all
|
|||
mkdir -p $(DESTDIR)$(ASTMANDIR)/man8
|
||||
install -m 644 keys/iaxtel.pub $(DESTDIR)$(ASTVARLIBDIR)/keys
|
||||
install -m 644 keys/freeworlddialup.pub $(DESTDIR)$(ASTVARLIBDIR)/keys
|
||||
install -m 644 asterisk.8.gz $(DESTDIR)$(ASTMANDIR)/man8
|
||||
install -m 644 asterisk.8 $(DESTDIR)$(ASTMANDIR)/man8
|
||||
install -m 644 contrib/scripts/astgenkey.8 $(DESTDIR)$(ASTMANDIR)/man8
|
||||
install -m 644 contrib/scripts/autosupport.8 $(DESTDIR)$(ASTMANDIR)/man8
|
||||
install -m 644 contrib/scripts/safe_asterisk.8 $(DESTDIR)$(ASTMANDIR)/man8
|
||||
|
|
|
@ -0,0 +1,165 @@
|
|||
.\" This manpage has been automatically generated by docbook2man
|
||||
.\" from a DocBook document. This tool can be found at:
|
||||
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/>
|
||||
.\" Please send any bug reports, improvements, comments, patches,
|
||||
.\" etc. to Steve Cheng <steve@ggi-project.org>.
|
||||
.TH "ASTERISK" "8" "17 May 2005" "asterisk 1.0" ""
|
||||
|
||||
.SH NAME
|
||||
asterisk \- All-purpose telephony server.
|
||||
.SH SYNOPSIS
|
||||
|
||||
\fBasterisk\fR [ \fB-tThfdvVqpRgcin\fR ] [ \fB-C \fIfile\fB\fR ] [ \fB-U \fIuser\fB\fR ] [ \fB-G \fIgroup\fB\fR ] [ \fB-x \fIcommand\fB\fR ] [ \fB-M \fIvalue\fB\fR ]
|
||||
|
||||
|
||||
\fBasterisk -r\fR [ \fB-v\fR ] [ \fB-x \fIcommand\fB\fR ]
|
||||
|
||||
.SH "DESCRIPTION"
|
||||
.PP
|
||||
\fBasterisk\fR is a full-featured telephony server which
|
||||
provides Private Branch eXchange (PBX), Interactive Voice Response (IVR),
|
||||
Automated Call Distribution (ACD), Voice over IP (VoIP) gatewaying,
|
||||
Conferencing, and a plethora of other telephony applications to a broad
|
||||
range of telephony devices including packet voice (SIP, IAX, MGCP, Skinny,
|
||||
H.323) devices (both endpoints and proxies), as well as traditional TDM
|
||||
hardware including T1, E1, ISDN PRI, GR-303, RBS, Loopstart, Groundstart,
|
||||
ISDN BRI, and many more.
|
||||
.PP
|
||||
Asterisk reads most of its configuration files from configuration files
|
||||
located in /etc/asterisk. Virtually all aspects of the operation of
|
||||
asterisk's configuration files can be found in the sample configuration
|
||||
files. The format for those files is generally beyond the scope of this
|
||||
man page.
|
||||
.PP
|
||||
When running with \fB-c\fR, \fB-r\fR or \fB-R\fR
|
||||
options, Asterisk supplies a powerful command line, including command
|
||||
completion, which may be used to monitors its status, perform a variety
|
||||
of administrative actions and even explore the applications that are
|
||||
currently loaded into the system.
|
||||
.SH "OPTIONS"
|
||||
.TP
|
||||
\fB-C \fIfile\fB\fR
|
||||
Use \fIfile\fR as master configuration file
|
||||
instead of the default, /etc/asterisk/asterisk.conf
|
||||
.TP
|
||||
\fB-c\fR
|
||||
Provide a control console on the calling terminal.
|
||||
Specifying this option implies \fB-f\fR and will cause
|
||||
asterisk to no longer fork or detach from the controlling terminal.
|
||||
.TP
|
||||
\fB-d\fR
|
||||
Enable extra debugging statements.
|
||||
.TP
|
||||
\fB-f\fR
|
||||
Do not fork or detach from controlling terminal.
|
||||
.TP
|
||||
\fB-g\fR
|
||||
Remove resource limit on core size, thus forcing Asterisk to dump
|
||||
core in the unlikely event of a segmentation fault or abort signal.
|
||||
\fBNOTE:\fR in some cases this may be incompatible
|
||||
with the \fB-U\fR or \fB-G\fR flags.
|
||||
.TP
|
||||
\fB-G \fIgroup\fB\fR
|
||||
Run as group \fIgroup\fR instead of the
|
||||
calling group. \fBNOTE:\fR this requires substantial work
|
||||
to be sure that Asterisk's environment has permission to write
|
||||
the files required for its operation, including logs, its comm
|
||||
socket, the asterisk database, etc.
|
||||
.TP
|
||||
\fB-h\fR
|
||||
Provide brief summary of command line arguments and terminate.
|
||||
.TP
|
||||
\fB-i\fR
|
||||
Prompt user to intialize any encrypted private keys during startup.
|
||||
.TP
|
||||
\fB-M \fIvalue\fB\fR
|
||||
Limits the maximum number of calls to the specified value. This can
|
||||
be useful to prevent a system from being brought down by terminating
|
||||
too many simultaneous calls.
|
||||
.TP
|
||||
\fB-n\fR
|
||||
Disable ANSI colors even on terminals capable of displaying them.
|
||||
.TP
|
||||
\fB-p\fR
|
||||
If supported by the operating system (and executing as root),
|
||||
attempt to run with realtime priority for increased performance and
|
||||
responsiveness within the Asterisk process, at the expense of other
|
||||
programs running on the same machine.
|
||||
.TP
|
||||
\fB-q\fR
|
||||
Reduce default console output when running in conjunction with
|
||||
console mode (\fB-c\fR).
|
||||
.TP
|
||||
\fB-r\fR
|
||||
Instead of running a new Asterisk process, attempt to connect
|
||||
to a running Asterisk process and provide a console interface
|
||||
for controlling it.
|
||||
.TP
|
||||
\fB-R\fR
|
||||
Much like \fB-r\fR\&. Instead of running a new Asterisk process, attempt to connect
|
||||
to a running Asterisk process and provide a console interface
|
||||
for controlling it. Additionally, if connection to the Asterisk
|
||||
process is lost, attempt to reconnect for as long as 30 seconds.
|
||||
.TP
|
||||
\fB-t\fR
|
||||
When recording files, write them first into a temporary holding directory,
|
||||
then move them into the final location when done.
|
||||
.TP
|
||||
\fB-T\fR
|
||||
Add timestamp to all non-command related output going to the console
|
||||
when running with verbose and/or logging to the console.
|
||||
.TP
|
||||
\fB-U \fIuser\fB\fR
|
||||
Run as user \fIuser\fR instead of the
|
||||
calling user. \fBNOTE:\fR this requires substantial work
|
||||
to be sure that Asterisk's environment has permission to write
|
||||
the files required for its operation, including logs, its comm
|
||||
socket, the asterisk database, etc.
|
||||
.TP
|
||||
\fB-v\fR
|
||||
Increase the level of verboseness on the console. The more times
|
||||
\fB-v\fR is specified, the more verbose the output is.
|
||||
Specifying this option implies \fB-f\fR and will cause
|
||||
asterisk to no longer fork or detach from the controlling terminal.
|
||||
This option may also be used in conjunction with \fB-r\fR
|
||||
and \fB-R\fR
|
||||
.TP
|
||||
\fB-V\fR
|
||||
Display version information and exit immediately.
|
||||
.TP
|
||||
\fB-x \fIcommand\fB\fR
|
||||
Connect to a running Asterisk process and execute a command on
|
||||
a command line, passing any output through to standard out and
|
||||
then terminating when the command execution completes. Implies
|
||||
\fB-r\fR when \fB-R\fR is not explicitly
|
||||
supplied.
|
||||
.SH "EXAMPLES"
|
||||
.PP
|
||||
\fBasterisk\fR - Begin Asterisk as a daemon
|
||||
.PP
|
||||
\fBasterisk -vvvgc\fR - Run on controlling terminal
|
||||
.PP
|
||||
\fBasterisk -rx "show channels"\fR - Display channels on running server
|
||||
.SH "BUGS"
|
||||
.PP
|
||||
Bug reports and feature requests may be filed at http://bugs.digium.com
|
||||
.SH "SEE ALSO"
|
||||
.PP
|
||||
*CLI> \fBhelp\fR - Help on Asterisk CLI
|
||||
.PP
|
||||
*CLI> \fBshow applications\fR - Show loaded applications
|
||||
.PP
|
||||
http://www.asterisk.org - The Asterisk Home Page
|
||||
.PP
|
||||
http://www.asteriskdocs.org - The Asterisk Documentation Project
|
||||
.PP
|
||||
http://www.voip-info.org/wiki-Asterisk - The Asterisk Wiki
|
||||
.PP
|
||||
http://www.digium.com/ - Asterisk sponsor and hardware supplier
|
||||
.PP
|
||||
http://www.markocam.com/ - Asterisk author's web cam
|
||||
.SH "AUTHOR"
|
||||
.PP
|
||||
Mark Spencer <markster@digium.com>
|
||||
.PP
|
||||
Countless other contributers, see CREDITS with distribution for more information
|
BIN
asterisk.8.gz
BIN
asterisk.8.gz
Binary file not shown.
Loading…
Reference in New Issue