semop 系统调用
功能描述:
操作一个或一组信号。
用法:
int semop(int semid, struct sembuf *sops, unsigned nsops);
int semtimedop(int semid, struct sembuf *sops, unsigned nsops, struct timespec *timeout);
参数:
semid :信号集的识别码,可通过 semget 获取。
sops :指向存储信号操作结构的数组指针,信号操作结构的原型如下
struct sembuf
{
unsigned short sem_num; /* semaphore number */
short sem_op; /* semaphore operation */
short sem_flg; /* operation flags */
};
这三个字段的意义分别为:
sem_num :操作信号在信号集中的编号,第一个信号的编号是 0 。
sem_op :如果其值为正数,该值会加到现有的信号内含值中。通常用于释放所控资源的使用权;如果 sem_op 的值为负数,而其绝 对值又大于信号的现值,操作将会阻塞,直到信号值大于或等于 sem_op 的绝对值。通常用于获取资源的使用权;如果 sem_op 的值为 0 ,则操作将暂时阻 塞,直到信号的值变为 0 。
sem_flg :信号操作标志,可能的选择有两种
IPC_NOWAIT // 对信号的操作不能满足时, semop() 不会阻塞,并立即返回,同时设定错误信息。
IPC_UNDO // 程序结束时 ( 不论正常或不正常 ) ,保证信号值会被重设为 semop() 调用前的值。这样做的目的在于避免程序在异常情况下结束时未将锁定的资源解锁, 造成该资源永远锁定。
nsops :信号操作结构的数量,恒大于或等于 1 。
timeout :当 semtimedop() 调用致使进程进入睡眠时,睡眠时间不能超过本参数指定的值。如果睡眠超 时, semtimedop() 将失败返回,并设定错误值为 EAGAIN 。如果本参数的值为 NULL , semtimedop() 将永远睡眠等待。
返回说明:
成功执行时,两个系统调用都返回 0 。失败返回 -1 , errno 被设为以下的某个值
E2BIG :一次对信号的操作数超出系统的限制
EACCES :调用进程没有权能执行请求的操作,并且不具有 CAP_IPC_OWNER 权能
EAGAIN :信号操作暂时不能满足,需要重试
EFAULT : sops 或 timeout 指针指向的空间不可访问
EFBIG : sem_num 指定的值无效
EIDRM :信号集已被移除
EINTR :系统调用阻塞时,被信号中断
EINVAL :参数无效
ENOMEM :内存不足
ERANGE :信号所允许的值越界