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)