Spelling corrections (mostly in comments and doxygen areas) #6249
[asterisk/asterisk.git] / asterisk.8
old mode 100755 (executable)
new mode 100644 (file)
index d03c787..28ea0ff
@@ -3,7 +3,7 @@
 .\" <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" ""
+.TH "ASTERISK" "8" "25 October 2005" "asterisk 1.2" ""
 
 .SH NAME
 asterisk \- All-purpose telephony server.
@@ -20,22 +20,25 @@ asterisk \- All-purpose telephony server.
 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,
+range of telephony devices including packet voice (SIP, IAX2, 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.
+At start, Asterisk reads the /etc/asterisk/asterisk.conf main configuration
+file and locates the rest of the configuration files from the configuration
+in that file. The -C option specifies an alternate main configuration file.
+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.
+.PP
+Asterisk is a trademark of Digium, Inc.
 .SH "OPTIONS"
 .TP
 \fB-C \fIfile\fB\fR
@@ -49,6 +52,10 @@ asterisk to no longer fork or detach from the controlling terminal.
 .TP
 \fB-d\fR
 Enable extra debugging statements.
+
+Note: This always sets the debug level in the asterisk process,
+even if it is running in the background. This will affect the size
+of your log files.
 .TP
 \fB-f\fR
 Do not fork or detach from controlling terminal.
@@ -70,7 +77,13 @@ socket, the asterisk database, etc.
 Provide brief summary of command line arguments and terminate.
 .TP
 \fB-i\fR
-Prompt user to intialize any encrypted private keys during startup.
+Prompt user to initialize any encrypted private keys for IAX2
+secure authentication during startup.
+.TP
+\fB-L \fIloadaverage\fB\fR
+Limits the maximum load average before rejecting new calls.  This can
+be useful to prevent a system from being brought down by terminating
+too many simultaneous calls.
 .TP
 \fB-M \fIvalue\fB\fR
 Limits the maximum number of calls to the specified value.  This can
@@ -122,7 +135,11 @@ Increase the level of verboseness on the console.  The more times
 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
+and \fB-R\fR\&.
+
+Note: This always sets the verbose level in the asterisk process,
+even if it is running in the background. This will affect the size
+of your log files.
 .TP
 \fB-V\fR
 Display version information and exit immediately.
@@ -147,7 +164,9 @@ Bug reports and feature requests may be filed at http://bugs.digium.com
 .PP
 *CLI> \fBhelp\fR - Help on Asterisk CLI
 .PP
-*CLI> \fBshow applications\fR - Show loaded applications
+*CLI> \fBshow applications\fR - Show loaded dialplan applications
+.PP
+*CLI> \fBshow functions\fR - Show loaded dialplan functions
 .PP
 http://www.asterisk.org - The Asterisk Home Page
 .PP