【正文】 utes。list_t *contacts。cseq_t *cseq。to_t *to。目前sip_t結構還沒有完成，非”From”、”To”、”Callid”、”CSeq”、”Via”、”Contact”、”Route”、”RecordRoute”、”MIMEVersion”、”ContentType”、”ContenLength”被存貯成一系列的通用頭部。[參數(shù)描述]int generic_param_getbyname(list_t *gen_params,char *name,generic_param_t **gen_param)。[參數(shù)描述]int generic_param_add(list_t *gen_params,char *name,char *value)。generic_param_getnamegeneric_paramsetnamegeneric_param_getvaluegeneric_param_setvalue[功能描述]此四個函數(shù)主要操作generic_param_t結構，對結構中的gname和gvalue進行取值和賦值操作。[參數(shù)描述]void generic_param_set(generic_param_t *gen_param,char *pname,char *pvalue)。generic_param_free[功能描述]釋放generic_param_t結構。[參數(shù)描述]int generic_param_init(generic_param_t *gen_param)成功返回0。tag=ae56frdz23}to_t。url_t *url。}generic_param_tTo結構和generic_param_t結構typedef struct _generic_param_t{char *gname。 int to_param_getbyname(to_t *to,char *pname,generic_param_t **dest)define to_gettag(T,GP) generic_param_getbyname((T)gen_params, sgetcopy(tag),GP)[參數(shù)描述]void to_settag(to_t *to,char *tag)注意：define to_set_tag(T,V) generic_param_add((T)gen_params, tag,V)注意：define to_param_get(T,I,GP) from_param_get((from_t*)T, I, GP)[參數(shù)描述]int to_param_get(to_t *to,int pos,generic_param_t **gp)。注意：define to_param_add(T,N,V) generic_param_add((T)gen_params,N,V)to_param_add[功能描述]在to字段中增加一個gen_param[參數(shù)描述]int to_param_add(to_t *to,char *name,char *value)。[參數(shù)描述]url_t *to_geturl(to_t *to)。to_seturl[功能描述]在to字段當中設定url值。[參數(shù)描述]char *to_getdisplayname(to_t *to)。第二部分：To特有的APIto_setdisplayname[功能描述]設定to字段里面的display name。to_clone[功能描述]將to信息克隆到目標[參數(shù)描述]int to_clone(to_t *to,to_t **dest)。成功返回0，失敗返回1。to_2char[功能描述]將to結構轉化賦值給一個字符串。[參數(shù)描述]void to_free(to_t *to)。[參數(shù)描述]int to_init(to_t **to)。 如果你想細致了解每一個字段的結構定義，請閱讀osip/；想了解字段對應的函數(shù)，請閱讀osip/，其對于功能描述、參數(shù)描述和使用描述都會有深入的理解。其他頭部通過特殊的API以串的格式存取。}to_t。url_t *url。在下面的API定義分三部分劃分并闡述，第一部分API用于創(chuàng)建、分配、分析和打印SIP的頭部元素；第二部分展示某頭部特有的API，在這里我僅僅展示”to”所特有的函數(shù)；第三部分是一些擴展的API，其不僅適合于”to”字段，同樣適合于”From”、”Contact”、”Route”、”RecordRoute”和其他頭部，著提供了頭部的擴展性。SIP headers操作的API在rfc2543中定義了大約40個字段。[參數(shù)描述]void url_param_getbyname(list_t *url_params,char *pname,url_param_t **url_param)url_param_getbyname[功能描述]在list_t列表中尋找含有pname的url_param，并將此參數(shù)對應關系值賦給url_param_t **url_param。[參數(shù)描述]void url_param_freelist(list_t *url_params)。[參數(shù)描述]int url_param_add(list_t *url_params,char *pname,char *pvalue)。url_param_set[功能描述]將字符串pname（參數(shù)名）和pvalue（參數(shù)名所對應的值）賦值到url_param_t結構當中。成功返回0。url_param_free[功能描述]釋放url_param所對應url_param_t結構實例。成功返回0。url_param_init[功能描述]初始化url_param_t結構。char *gvalue。}url_param_t。param參數(shù)的結構定義如下：typedef struct _url_parm_t{char *gname。在下面的描述的param的函數(shù)中，你只要將param換為header，即可完成對url_header_t的操作。 url_param_add(Uurl_params, maddr, M)這些函數(shù)都是必要理解的（參照osip/） url_param_add(Uurl_params, ttl, T)define url_set_maddr(U, M) url_param_add(Uurl_params, method, M)define url_set_ttl(U, T) url_param_add(Uurl_params, method, BYE)define url_set_method_cancel(U) url_param_add(Uurl_params, method, ACK)define url_set_method_options(U) url_param_add(Uurl_params, method, OPTIONS)define url_set_method_bye(U)url_param_add(Uurl_params, method, INVITE)define url_set_method_ack(U) url_param_add(Uurl_params, user, USER) url_param_add(Uurl_params, user, ip)define url_set_user(U, USER) url_param_add(Uurl_params, transport, T) url_param_add(Uurl_params, transport, tls)define url_set_transport(U,T)url_param_add(Uurl_params, transport, sctp)define url_set_transport_tls(U)char* url_gethost(url_t *url)。char* url_getusername(url_t *url)。url_getschemeurl_getusernameurl_getpasswordurl_gethosturl_getport[功能描述]獲取url當中的一些特定部分的值，并返回。 void url_setport(url_t *url, char *port)。 void url_setpassword(url_t *url, char *password)。url_setschemeurl_setusernameurl_setpasswordurl_sethosturl_setport[功能描述]設定url當中的摘要部分、用戶名、密碼、主機和端口[參數(shù)描述]void url_setscheme(url_t *url, char *scheme)。成功返回0，失敗返回1。url_clone[功能描述]進行兩個url_t結構實例的復制（使用標準函數(shù)memcpy也可以完成，但對于鏈表不一定可以，未曾測試）。char **field_value會在url_2char中做初始化。[參數(shù)描述]int url_2char(url_t *url,char **field_value)。[參數(shù)描述]int url_parse(url_t *url,char *filed_value)。url_free[功能描述]釋放操作完成的url_t結構，并對url_t結構中的變量賦值為空。成功返回0，失敗會使程序自動退出。一般而言，分配內(nèi)存調(diào)用malloc，釋放內(nèi)存調(diào)用free，由于作者做了改寫使的調(diào)用的函數(shù)分別為smalloc和sfree，初賦值做的就是將一些變量賦值為0或NULL）。}url_turl_t結構體操作的APIurl_init[功能描述]分配內(nèi)存，并對結構體作初始化。list_t *url_params。char *host。char *username。在開發(fā)庫中用url_t格式去定義如下字段：”To”、”From”、”Contact”、”Route”和”RecordRoute”；list_t擴展定義了url中包含的固定參數(shù)和不固定的頭部值。SIPURL（SIP地址）URL定義的語法結構和設計目標URL被用于描述分布在SIP網(wǎng)絡中的每一個實體：SIP用戶代理、定位服務器、SIP代理服務器、SIP重定向服務器等等。./。GNU/Linux（）被用于最初的開發(fā)。 開發(fā)庫建造初便考慮了可移植性，其可以被很快應用于支持POSIX的任何系統(tǒng)當中。如果你像開發(fā)stateful proxy，應閱讀最后的“Proxy開發(fā)的注意點”和前面的事務管理。并且，oSIP并不和任何SIP開發(fā)商和操作系統(tǒng)緊密結合。開發(fā)庫能夠被用于多線程模式或者不使用，這完全由開發(fā)者決定。事務管理已經(jīng)被測試，表現(xiàn)的很穩(wěn)定。最后，我們需要建造多媒體應用部分。之后，我們將需要建造時鐘管理的模塊（一個簡單的，遠沒有達到優(yōu)秀得一個樣例已經(jīng)被提供）。首先，我們建造一個管理傳輸層特性的模塊。一系列的動態(tài)回叫注冊，用于應用程序得知每一個事物的進展情況。每一個事物使用獨立的FIFO，這些隊列被外部模塊填充。事務管理oSIP公布了一個易于使用的用戶界面。oSIP不能維持如下可靠性：（不過，oSIP保持完整的適應性）頭部字段的順序一行中出現(xiàn)多個頭部字段中出現(xiàn)額外的空格出現(xiàn)LWS（內(nèi)部的CRLF）在to,from,contact…字段中出現(xiàn)引號有限狀態(tài)機4個有限狀態(tài)機已經(jīng)被測試過。有時不希望的行為可能發(fā)生。更多的頭部將會被增加進來。目前oSIP能夠分析很小一部分頭部，例如Via、CallID、To、From、Contact、Cseq、Route、RecordRoute、mimeversion、ContentType和Contentlength。如果發(fā)現(xiàn)了，請務必報告到osip，我將修正他們。、很好適應性的SIP語法分析器。oSIP被眾所周知應用于實時操作系統(tǒng)VxWorks當中，并且其他支持將是簡單的事情。作為開發(fā)者的我們，可以在應用程序設計時進行選擇。OSIP具有足夠的靈活和微小，以便在小的操作系統(tǒng)（例如手持設備）滿足其特定要求。所有的這些都平添了Linux將作為下一代電話產(chǎn)品的機會。發(fā)展的一個側面是在不久的將來，Linux將更多支持多媒體工具。oSIP開發(fā)庫是第一個自