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.