From 509c285380cdebddfe3e408a12484d80c1319ae2 Mon Sep 17 00:00:00 2001 From: "Kevin P. Fleming" Date: Thu, 15 Sep 2005 00:12:36 +0000 Subject: [PATCH] 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 --- Makefile | 7 +-- asterisk.8 | 165 ++++++++++++++++++++++++++++++++++++++++++++++++++ asterisk.8.gz | Bin 2547 -> 0 bytes 3 files changed, 168 insertions(+), 4 deletions(-) create mode 100755 asterisk.8 delete mode 100755 asterisk.8.gz diff --git a/Makefile b/Makefile index 72e198fdee..f1c48c2c5b 100755 --- a/Makefile +++ b/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 diff --git a/asterisk.8 b/asterisk.8 new file mode 100755 index 0000000000..d03c7873ed --- /dev/null +++ b/asterisk.8 @@ -0,0 +1,165 @@ +.\" This manpage has been automatically generated by docbook2man +.\" from a DocBook document. This tool can be found at: +.\" +.\" Please send any bug reports, improvements, comments, patches, +.\" etc. to Steve Cheng . +.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 +.PP +Countless other contributers, see CREDITS with distribution for more information diff --git a/asterisk.8.gz b/asterisk.8.gz deleted file mode 100755 index d05b828286821f76e2b02f98eac700d760fae784..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 2547 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