Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

astribank_is_starting(8) [debian man page]

ASTRIBANK_IS_STARTING(8)												  ASTRIBANK_IS_STARTING(8)

NAME

       astribank_is_starting - Mark / check is a Xorcom Astribank (xpp) is starting

SYNOPSIS

       astribank_is_starting [-d] [-v] [-t timeout] <-a|-r|-w>

       astribank_is_starting [-d] [-v]

       astribank_is_starting -h

DESCRIPTION

       astribank_is_starting is an internal tool used by various xpp scripts to mark that there may be an Astribank device currently initializing,
       and to check for that mark.

       Technically the mark is a SysV semaphore.

OPTIONS

       -a
	      Add.  Set the mark. Should return 0 unless there's an error.

       -r
	      Remove.  Reset the mark. Should return 0 unless there's an error.

       -ttimeout
	      Timeout.	Set the timeout value for the -w option. Default is 60 seconds.

       -w
	      Wait.  Wait for mark to be reset. Should return 0 unless there's an error.

       Without -a or -r: return 0 if the mark has been set, or a non-zero value otherwise.

       -d
	      Print debug information to stderr.

       -v
	      Verbose execution.

       -h
	      Displays usage message.

FILES

       /proc/sysvipc/sem
	      If set, the astribank should appear there with the ID 11211168 (0xAB11A0).  Naturally the ID (or rather, the usage of a semaphore in
	      the first place) is an implementation detail that may change.

NOTES

       astribank_is_starting  is used to mark the fact that an Astribank may be currently reenumerating (technically: distonnecting and connecting
       as a new USB device) after loading the firmware. Thus the script that loads the firmware (/usr/share/dahdi/xpp_fxloader) uses this  utility
       to set the mark.

       The mark is reset by /usr/share/dahdi/waitfor_xpds , which is typically run by the DAHDI init script and waits for all Astribanks to finish
       loading.

       Q: Why do you use a semaphore?

       A: because, unlike the filesystem, it is writable at any given time.

BUGS

       Option ordering matter. The -v and -d options should preceed the actions (-a, -r and -w).  The  -ttimeout  option  should  preceed  the	-w
       option.

SEE ALSO

       semctl(3)

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.

								  16 August 2009					  ASTRIBANK_IS_STARTING(8)

Check Out this Related Man Page

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

NAME

       autosupport -- interactive script to provide Digium[tm]'s support with information

SYNOPSIS

       autosupport [OPTION] [prefix]

DESCRIPTION

       autosupport  is a script that is normally run by a user contacting Digium's Technical Support to automate gathering support information. It
       will probe the system for some run-time and system information, and generate a backup of Asterisk related configuration. An optional param-
       eter for a prefix may be specified which is typically used to specify a Digium Technical Support Ticket ID.

       The script requires root privileges to run, and writes all output in the home directory of the user running the script. For the purposes of
       this document, this will be referred to as /root/ henceforth.

       The system information is written to /root/digiuminfo.txt and the backup of configuration (and the system information file) are written	to
       a  tarball in /root/ with a base name of digium-info. A Date Stamp will be appended, and if specified the optional parameter will be a pre-
       fix. The tarball at least is expected to be attached to a support ticket with Digium.

OPTIONS

   Arguments:
       prefix	      Used to prefix the file names. Typically a Digium Technical Support Ticket ID

   Options:
       -n, --non-interactive	Run without requiring user input

       -h, --help		Show help about options

FILES

       /root/digiuminfo.txt
       /root/digium-info_YYYYMMDD.tar.gz

SEE ALSO

       asterisk(8)

AUTHOR

       autosupport was written by John Bigelow <support@digium.com> in conjunction with Charles Moye and Trey Blancher. This manual page was writ-
       ten  by	Tzafrir Cohen <tzafrir.cohen@xorcom.com> and updated by Charles Moye. 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.

autosupport							  Dec 14th, 2011						    AUTOSUPPORT(8)
Man Page