ASTRIBANK_IS_STARTING - reference manual online
Mark / check is a Xorcom Astribank (xpp) is starting.
16 August 2009
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). Natu‐ rally the ID (or rather, the usage of a semaphore in the first place) is an imple‐ mentation detail that may change. NOTES astribank_is_starting is used to mark the fact that an Astribank may be currently reenu‐ merating (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)16 August 2009 ASTRIBANK_IS_STARTING(8)
|This manual||Reference||Other manuals|