在这个库里，与用户有关的接口主要有：

typedef struct tp_work_desc_s tp_work_desc;

typedef struct tp_work_s tp_work;

typedef struct tp_thread_info_s tp_thread_info;

typedef struct tp_thread_pool_s tp_thread_pool;

         //thread parm

struct tp_work_desc_s{

                  ……

};

//base thread struct

struct tp_work_s{

                  //main process function. user interface

                  void (*process_job)(tp_work *this, tp_work_desc *job);

};

tp_thread_pool *creat_thread_pool(int min_num, int max_num);

tp_work_desc_s表示应用线程执行任务时所需要的一些信息，会被当作线程的参数传递给每个线程，依据应用的不同而不同，需要用户定义结构的内容。tp_work_s就是我们希望线程执行的任务了。当我们申请分配一个新的线程时，首先要明确的指定这两个结构，即该线程完成什么任务，并且完成这个任务需要哪些额外的信息。接口函数creat_thread_pool用来创建一个线程池的实例，使用时需要指定该线程池实例所能容纳的最小线程数min_num和最大线程数max_num。最小线程数即线程池创建时预创建的线程数目，这个数目的大小也直接影响了线程池所能起到的效果，如果指定的太小，线程池中预创建的线程很快就将分配完毕并需要创建新的线程来适应不断的请求，如果指定的太大，则将可能会有大量的空闲线程。我们需要根据自己应用的实际需要进行指定。描述线程池的结构如下：

//main thread pool struct

struct tp_thread_pool_s{

         TPBOOL (*init)(tp_thread_pool *this);

         void (*close)(tp_thread_pool *this);

         void (*process_job)(tp_thread_pool *this, tp_work *worker, tp_work_desc *job);

         int  (*get_thread_by_id)(tp_thread_pool *this, int id);

         TPBOOL (*add_thread)(tp_thread_pool *this);

         TPBOOL (*delete_thread)(tp_thread_pool *this);

         int (*get_tp_status)(tp_thread_pool *this);

         int min_th_num;                //min thread number in the pool

         int cur_th_num;                 //current thread number in the pool

         int max_th_num;         //max thread number in the pool

         pthread_mutex_t tp_lock;

         pthread_t manage_thread_id;  //manage thread id num

         tp_thread_info *thread_info;   //work thread relative thread info

};

结构tp_thread_info_s描述了各个线程id、是否空闲、执行的任务等信息，用户并不需要关心它。

//thread info

struct tp_thread_info_s{

         pthread_t          thread_id;         //thread id num

         TPBOOL                   is_busy;    //thread status:true-busy;flase-idle

         pthread_cond_t          thread_cond;

         pthread_mutex_t               thread_lock;

         tp_work                      *th_work;

         tp_work_desc            *th_job;

};

tp_thread_pool_s结构包含了有关线程池操作的接口和变量。在使用creat_thread_pool返回一个线程池实例之后，首先要使用明确使用init接口对它进行初始化。在这个初始化过程中，线程池会预创建指定的最小线程数目的线程，它们都处于阻塞状态，并不损耗CPU，但是会占用一定的内存空间。同时init也会创建一个线程池的管理线程，这个线程会在线程池的运行周期内一直执行，它将定时的查看分析线程池的状态，如果线程池中空闲的线程过多，它会删除部分空闲的线程，当然它并不会使所有线程的数目小于指定的最小线程数。

在已经创建并初始化了线程池之后，我们就可以指定tp_work_desc_s和tp_work_s结构，并使用线程池的process_job接口来执行它们。这些就是我们使用这个线程池时所需要了解的所有东西。如果不再需要线程池，可以使用close接口销毁它。