sip_to_pjsip.py: Fix typo converting outboundproxy registration.
[asterisk/asterisk.git] / contrib / scripts / safe_asterisk.8
1 .TH SAFE_ASTERISK 8 "Jun 30th, 2005" "Asterisk" "Linux Programmer's Manual"
2 .SH NAME
3 .B safe_asterisk
4 \(em A wrapper to run the asterisk executable in a loop
5 .SH SYNOPSIS
6 .PP 
7 .B safe_asterisk
8 .I [ asterisk_params ]
9
10 .SH DESCRIPTION
11 .B safe_asterisk 
12 is a script that runs asterisk in a loop, which can be useful if you 
13 fear asterisk may crash.
14
15 The script does not run in the background like a standard service. Rather, 
16 it runs in its own linux virtual console (9, by default).
17 It also uses the option '\-c' of asterisk(8) to avoid detaching asterisk 
18 from that terminal.
19
20 safe_asterisk also runs asterisk with unlimited core file size, and thus 
21 asterisk will dump core in case of a crash.
22
23 To get a "picture" of console 9, from another terminal (e.g: from a 
24 remote shell session) you can use:
25
26   screendump 9
27
28 The init script of the Debian package should be able to run safe_asterisk 
29 as the asterisk service, if so configured. See coments in 
30 /etc/default/asterisk
31
32 .SH FILES
33 .B /tmp
34 .RS
35 safe_asterisk runs in that directory, rather than in / as usual.
36 .RE
37
38 .B /tmp/core
39 .RS
40 If core files were generated there, they may be 
41 .RE
42
43 .B /etc/asterisk/startup.d
44 .RS
45 Files in this directory will be 'source'd by the safe_asterisk script before
46 it starts Asterisk proper, allowing them to set additional environment variables
47 or run any other steps that are needed for your system.
48 .RE
49
50 .SH BUGS
51 While showing the output on a console is useful, using screen(1) as 
52 the terminal may be better.
53
54 The script does not read configuration from standard location under /etc
55
56 It uses fixed locations under /tmp , and thus may be exposed to a 
57 symlink attacks.
58
59 .SH SEE ALSO
60 asterisk(8), screendump(9)
61
62 .SH "AUTHOR" 
63 This manual page was written by Tzafrir Cohen <tzafrir.cohen@xorcom.com> 
64 Permission is granted to copy, distribute and/or modify this document under 
65 the terms of the GNU General Public License, Version 2 any  
66 later version published by the Free Software Foundation. 
67
68 On Debian systems, the complete text of the GNU General Public 
69 License can be found in /usr/share/common\-licenses/GPL\-2.