信号量

sem_init

头文件

  #include<semaphore.h>

函数原型:

  int sem_init(sem_t *sem, int pshared, unsigned int value);

说明:

  sem_init() 初始化一个定位在 sem 的匿名信号量。
  value 参数指定信号量的初始值。
  pshared 参数指明信号量是由进程内线程共享，还是由进程之间共享。
    如果 pshared 的值为 0，那么信号量将被进程内的线程共享，并且应该放置在这个进程的所有线程都可见的地址上(如全局变量，或者堆上动态分配的变量)。

    如果 pshared 是非零值，那么信号量将在进程之间共享，并且应该定位共享内存区域。

返回值:

  sem_init() 成功时返回 0；错误时，返回 -1，并把 errno 设置为合适的值

sem_post

头文件：

  #include <semaphore.h>

函数原型：

  int sem_post(sem_t *sem);

说明：

  sem_post函数的作用是给信号量的值加上一个“1”，它是一个“原子操作”－－－即同时对同一个信号量做加“1”操作的两个线程是不会冲突的；而同 时对同一个文件进行读、加和写操作的两个程序就有可能会引起冲突。信号量的值永远会正确地加一个“2”－－因为有两个线程试图改变它。 当有线程阻塞在这个信号量上时，调用这个函数会使其中一个线程不在阻塞，选择机制是有线程的调度策略决定的。

返回值：

  sem_post() 成功时返回 0；错误时，信号量的值没有更改，-1 被返回，并设置 errno 来指明错误。

sem_wait

头文件：

  #include <semaphore.h>

函数原型：

  int sem_wait(sem_t * sem);

函数说明：

  sem_wait函数也是一个原子操作，它的作用是从信号量的值减去一个“1”，但它永远会先等待该信号量为一个非零值才开始做减法。也就是说，如果你对一个值为2的信号量调用sem_wait(),线程将会继续执行，这信号量的值将减到1。如果对一个值为0的信号量调用sem_wait()，这个函数就 会地等待直到有其它线程增加了这个值使它不再是0为止。如果有两个线程都在sem_wait()中等待同一个信号量变成非零值，那么当它被第三个线程增加 一个“1”时，等待线程中只有一个能够对信号量做减法并继续执行，另一个还将处于等待状态。sem_trywait(sem_t *sem)是函数sem_wait的非阻塞版，它直接将信号量sem减1，同时返回错误代码。

描述：

sem_wait() 减小(锁定)由sem指定的信号量的值.如果信号量的值比0大,
　　那么进行减一的操作,函数立即返回.
　　如果信号量当前为0值,那么调用就会一直阻塞直到或者是信号量变得可以进行减一的操作
　　(例如,信号量的值比0大),或者是信号处理程序中断调用

sem_trywait() 和 sem_wait()是一样的,除了如果不能够对信号量立即进行减一,
　　那么sem_trywait()就会返回一个错误(错误号是AGAIN)而不是锁定.
　　sem_timedwait() 和 sem_wait()是一样的,除了如果减一操作不能立即执行的话,
　　abs_timeout 指定了调用应该被阻塞的时间限制.
　　abs_timeout 参数指向了一个结构体指定了由秒和纳秒组成的绝对的超时值:
　　从1970-01-01 00:00:00 +0000纪元开始的UTC,结构体的定义如下:
　　struct timespec
　　{
　　time_t tv_sec; /* Seconds */
　　long tv_nsec; /* Nanoseconds [0 .. 999999999] */
　　};
　　如果超时值已经超过了调用规定的值,那么信号量不能被立即锁定,
　　之后sem_timedwait() 为超时失败(error设置为ETIMEDOUT).

  如果操作立即生效,那么sem_timedwait() 永远不会返回超时的错误,不管abs_timeout的值.
　　更进一步的是,在这种情况下abs_timeout值的有效性都不会检查.

返回值：

  所有的函数成功返回0,错误的话信号量的值不改动,返回-1.errno设定来标识错误.

sem_destroy

sem_destroy - 销毁一个匿名信号量

头文件：

  #include <semaphore.h>

函数原型：

  int sem_destroy(sem_t *sem);

描述：

  sem_destroy() 销毁由sem指向的匿名信号量。

只有通过sem_init(3) 初始化的信号量才应该使用sem_destroy() 销毁。

销毁一个有其它线程或进程当前阻塞(在sem_wait(3))的信号量将导致未定义行为。

使用一个已经销毁的信号量将导致未定义结果，除非这个信号量已经使用sem_init(3) 重新初始化了。

返回值：

  sem_destroy() 成功时返回 0；错误时，返回 -1，并把errno设置为合适的值。