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 .SH BUGS
  44 While showing the output on a console is useful, using screen(1) as
  45 the terminal may be better.
  46
  47 The script does not read configuration from standard location under /etc
  48
  49 It uses fixed locations under /tmp , and thus may be exposed to a
  50 symlink attacks.
  51
  52 .SH SEE ALSO
  53 asterisk(8), screendump(9)
  54
  55 .SH "AUTHOR"
  56 This manual page was written by Tzafrir Cohen <tzafrir.cohen@xorcom.com>
  57 Permission is granted to copy, distribute and/or modify this document under
  58 the terms of the GNU General Public License, Version 2 any
  59 later version published by the Free Software Foundation.
  60
  61 On Debian systems, the complete text of the GNU General Public
  62 License can be found in /usr/share/common-licenses/GPL.