mirror of
				https://github.com/asterisk/asterisk.git
				synced 2025-11-03 04:16:43 +00:00 
			
		
		
		
	Correct typos of the following word families: standard increase comments valgrind promiscuous editing libtonezone storage aggressive whitespace russellbryant consecutive peternixon ASTERISK-29714 Change-Id: I9cafbf41b579c9c0c84c81719d2c4f900beec245
		
			
				
	
	
		
			70 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
			
		
		
	
	
			70 lines
		
	
	
		
			2.0 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
.TH SAFE_ASTERISK 8 "Jun 30th, 2005" "Asterisk" "Linux Programmer's Manual"
 | 
						|
.SH NAME
 | 
						|
.B safe_asterisk
 | 
						|
\(em A wrapper to run the asterisk executable in a loop
 | 
						|
.SH SYNOPSIS
 | 
						|
.PP
 | 
						|
.B safe_asterisk
 | 
						|
.I [ asterisk_params ]
 | 
						|
 | 
						|
.SH DESCRIPTION
 | 
						|
.B safe_asterisk
 | 
						|
is a script that runs asterisk in a loop, which can be useful if you
 | 
						|
fear asterisk may crash.
 | 
						|
 | 
						|
The script does not run in the background like a standard service. Rather,
 | 
						|
it runs in its own linux virtual console (9, by default).
 | 
						|
It also uses the option '\-c' of asterisk(8) to avoid detaching asterisk
 | 
						|
from that terminal.
 | 
						|
 | 
						|
safe_asterisk also runs asterisk with unlimited core file size, and thus
 | 
						|
asterisk will dump core in case of a crash.
 | 
						|
 | 
						|
To get a "picture" of console 9, from another terminal (e.g: from a
 | 
						|
remote shell session) you can use:
 | 
						|
 | 
						|
  screendump 9
 | 
						|
 | 
						|
The init script of the Debian package should be able to run safe_asterisk
 | 
						|
as the asterisk service, if so configured. See comments in
 | 
						|
/etc/default/asterisk
 | 
						|
 | 
						|
.SH FILES
 | 
						|
.B /tmp
 | 
						|
.RS
 | 
						|
safe_asterisk runs in that directory, rather than in / as usual.
 | 
						|
.RE
 | 
						|
 | 
						|
.B /tmp/core
 | 
						|
.RS
 | 
						|
If core files were generated there, they may be
 | 
						|
.RE
 | 
						|
 | 
						|
.B /etc/asterisk/startup.d
 | 
						|
.RS
 | 
						|
Files in this directory will be 'source'd by the safe_asterisk script before
 | 
						|
it starts Asterisk proper, allowing them to set additional environment variables
 | 
						|
or run any other steps that are needed for your system.
 | 
						|
.RE
 | 
						|
 | 
						|
.SH BUGS
 | 
						|
While showing the output on a console is useful, using screen(1) as
 | 
						|
the terminal may be better.
 | 
						|
 | 
						|
The script does not read configuration from standard location under /etc
 | 
						|
 | 
						|
It uses fixed locations under /tmp , and thus may be exposed to a
 | 
						|
symlink attacks.
 | 
						|
 | 
						|
.SH SEE ALSO
 | 
						|
asterisk(8), screendump(9)
 | 
						|
 | 
						|
.SH "AUTHOR"
 | 
						|
This manual page was written by Tzafrir Cohen <tzafrir.cohen@xorcom.com>
 | 
						|
Permission is granted to copy, distribute and/or modify this document under
 | 
						|
the terms of the GNU General Public License, Version 2 any
 | 
						|
later version published by the Free Software Foundation.
 | 
						|
 | 
						|
On Debian systems, the complete text of the GNU General Public
 | 
						|
License can be found in /usr/share/common\-licenses/GPL\-2.
 |