debian man page for safe_asterisk

SAFE_ASTERISK(8)					     Linux Programmer's Manual						  SAFE_ASTERISK(8)

NAME
       safe_asterisk -- A wrapper to run the asterisk executable in a loop

SYNOPSIS
       safe_asterisk [ asterisk_params ]

DESCRIPTION
       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  coments	in
       /etc/default/asterisk

FILES
       /tmp
	      safe_asterisk runs in that directory, rather than in / as usual.

       /tmp/core
	      If core files were generated there, they may be

       /etc/asterisk/startup.d
	      Files  in  this directory will be 'source'd by the safe_asterisk script before it starts Asterisk proper, allowing them to set addi-
	      tional environment variables or run any other steps that are needed for your system.

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.

SEE ALSO
       asterisk(8), screendump(9)

AUTHOR
       This manual page was written by Tzafrir Cohen <tzafrir.cohen@xorcom.com> Permission is granted to copy, distribute and/or modify this docu-
       ment 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.

Asterisk							  Jun 30th, 2005						  SAFE_ASTERISK(8)