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 -r -ttimeout -w Without -a or -r: return 0 if the mark has been set, or a non-zero value otherwise. -d -v -h

FILES¶

/proc/sysvipc/sem

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.