【semctl系統呼叫】  
   
功能描述：
在指定的訊號集或訊號集內的某個訊號上執行控制操作。

 
用法： 
#include <sys/types.h>
#include <sys/ipc.h>
#include <sys/sem.h>

int semctl(int semid, int semnum, int cmd, ...);

引數：  
semid：訊號集的識別符號，即是訊號表的索引。
semnum：訊號集的索引，用來存取訊號集內的某個訊號。
cmd：需要執行的命令，有效值有

IPC_STAT //將與semid關聯的核心資料結構拷貝到由arg.buf指標指向的記憶體區。
IPC_SET //將由arg.buf指標指向的semid_ds的一些成員寫入相關聯的核心資料結構，同時更新它的sem_ctime成員。
IPC_RMID //立即刪除訊號集，喚醒所有被阻塞的程序。
IPC_INFO //Linux特有命令，返回系統範圍內關於訊號集的制約和其它引數，並存放在arg.__buf指向的記憶體區。其結構形態如下：

struct  seminfo {
    int semmap;  /* # of entries in semaphore map; unused */
    int semmni;  /* Max. # of semaphore sets */
    int semmns;  /* Max. # of semaphores in all semaphore sets */
    int semmnu;  /* System-wide max. # of undo structures; unused */
    int semmsl;  /* Max. # of semaphores in a set */
    int semopm;  /* Max. # of operations for semop() */
    int semume;  /* Max. # of undo entries per process; unused */
    int semusz;  /* size of struct sem_undo */
    int semvmx;  /* Maximum semaphore value */
    int semaem;  /* Max. value that can be recorded for semaphore adjustment (SEM_UNDO) */
};

SEM_INFO //返回和IPC_INFO相同的資訊，不同點有：semusz欄位包含有當前系統存在的訊號集總量。semaem欄位包含有系統內所有訊號集的訊號總量。
SEM_STAT //返回和IPC_STAT相同的資訊。不過引數semid不是一個訊號集標識，而是核心內部維持所有訊號集資訊的陣列索引。
GETALL //將所有訊號的值存入semun.array中。
GETNCNT //等待訊號值增加的程序的總數。
GETPID //前一個對此訊號進行操作的程序的識別碼。
GETVAL //根據semnun返回訊號的值。
GETZCNT //等待訊號值變為0的程序的總數。
SETALL //將所有semun.array的值設定到訊號集中。
SETVAL //根據semun設定訊號的值。

...：對於不同的命令，可能需要用到也可能不需要，是一個聯合體，原型如下

union semun {
 int              val;    /* Value for SETVAL */
    struct semid_ds *buf;    /* Buffer for IPC_STAT, IPC_SET */
    unsigned short  *array;  /* Array for GETALL, SETALL */
    struct seminfo  *__buf;  /* Buffer for IPC_INFO (Linux specific) */
};
 
semid_ds結構體定義在<sys/sem.h>，原型如下

struct semid_ds {
    struct ipc_perm sem_perm;  /* Ownership and permissions
    time_t          sem_otime; /* Last semop time */
    time_t          sem_ctime; /* Last change time */
    unsigned short  sem_nsems; /* No. of semaphores in set */
};

ipc_perm結構體定義在<sys/ipc.h>，原型如下

struct ipc_perm {
    key_t key;            /* Key supplied to semget() */
    uid_t uid;            /* Effective UID of owner */
    gid_t gid;            /* Effective GID of owner */
 uid_t cuid;           /* Effective UID of creator */
    gid_t cgid;           /* Effective GID of creator */
    unsigned short mode;  /* Permissions */
    unsigned short seq;   /* Sequence number */
};

返回說明：  
成功執行時，根據不同的命令返回不同的非負值

GETNCNT //返回semncnt的值
GETPID  //返回sempid的值
GETVAL  //返回semval的值
GETZCNT //返回semzcnt的值
IPC_INFO //返回核心內部關於訊號集資訊的最大可用入口索引
SEM_INFO //如同IPC_INFO.
SEM_STAT //返回訊號集標識
剩下的命令返回0。

失敗返回-1，errno被設為以下的某個值  
EACCES：訪問出錯，權能不允許
EFAULT：arg.buf 或 arg.array所指的空間不可訪問
EIDRM：訊號集已被刪除
EINVAL；引數無效
EPERM：權能不允許
ERANGE：給出的引數無效