NIS 函數(shù)庫
nis 的全名為 network information system,另外一個說法就是 yp (yellow pages)。nis 或 yp 可以讓許多不同的 unix 機器擁有相同的系統(tǒng)信息,例如相同的用戶帳號密碼,使系統(tǒng)管理人員及用戶都容易在不同的機器間穿梭,不可避免的,會有安全上的缺點,不過安全就不是這兒所討論的了。而關(guān)于 nis 方面的中英文書籍在市面上都可以找到,或者也可以參考 http://www.desy.de/~sieversm/ypdoku/ypdoku/ypdoku.html 。
欲使用 nis 函數(shù)庫,記得要在編譯 php 時將 yp 的選項打開,即加上 --with-yp 選項。
yp_get_default_domain: 取得機器的 domain。
yp_order: 返回 map 的序數(shù)。
yp_master: 取得 nis 的 master。
yp_match: 取得指定資料。
yp_first: 返回 map 上第一筆符合的資料。
yp_next: 指定 map 的下筆資料。
yp_errno: 取得先前 yp 操作的錯誤碼。
yp_err_string: 取得先前 yp 操作的錯誤字符串。
yp_get_default_domain
取得機器的 domain。
語法: string yp_get_default_domain(void);
返回值: 字符串
函數(shù)種類: 網(wǎng)絡(luò)系統(tǒng)
內(nèi)容說明: 本函數(shù)用來尋找服務(wù)器本身所處的 domain。執(zhí)行成功則返回 domain 字符串,失敗則返回 false。本函數(shù)執(zhí)行時不需要加參數(shù)。
使用范例
參考: yp_errno() yp_err_string()
yp_order
返回 map 的序數(shù)。
語法: int yp_order(string domain, string map);
返回值: 整數(shù)
函數(shù)種類: 網(wǎng)絡(luò)系統(tǒng)
內(nèi)容說明: 本函數(shù)用來取得 map 的序數(shù),在取得 domain 及 map 之后使用。返回值為 map 序數(shù),若失敗則返回 false。
使用范例
參考: yp_get_default_domain() yp_errno() yp_err_string()
yp_master
取得 nis 的 master。
語法: string yp_master(string domain, string map);
返回值: 字符串
函數(shù)種類: 網(wǎng)絡(luò)系統(tǒng)
內(nèi)容說明: 本函數(shù)用來獲取目前所在 domain 上的 master 機器,在取得 domain 及 map 之后使用。
參考: yp_get_default_domain() yp_errno() yp_err_string()
yp_match
取得指定資料。
語法: string yp_match(string domain, string map, string key);
返回值: 字符串
函數(shù)種類: 網(wǎng)絡(luò)系統(tǒng)
內(nèi)容說明: 本函數(shù)用來獲取指定 domain 中 map 中的指定資料。參數(shù) key 可指定用戶名稱等。
使用范例
下例用來取得 wilson 的信息
返回字符串類似下面的字符串
wilson:##wilson:12345:380:wilson peng:/home/wilson:/bin/bash
參考: yp_get_default_domain() yp_errno() yp_err_string()
yp_first
返回 map 上第一筆符合的資料。
語法: array yp_first(string domain, string map);
返回值: 數(shù)組
函數(shù)種類: 網(wǎng)絡(luò)系統(tǒng)
內(nèi)容說明: 本函數(shù)用來取得指定 map 上第一筆返回資料的索引和其值。返回資料為數(shù)組,若失敗則返回 false。
使用范例
參考: yp_get_default_domain() yp_errno() yp_err_string()
yp_next
指定 map 的下筆資料。
語法: array yp_next(string domain, string map, string key);
返回值: 數(shù)組
函數(shù)種類: 網(wǎng)絡(luò)系統(tǒng)
內(nèi)容說明: 本函數(shù)用來取得 map 上指定資料的下筆返回資料的索引和其值。返回資料為數(shù)組,若失敗則返回 false。
使用范例
參考: yp_get_default_domain() yp_errno() yp_err_string()
yp_errno
取得先前 yp 操作的錯誤碼。
語法: int yp_errno(void);
返回值: 整數(shù)
函數(shù)種類: 網(wǎng)絡(luò)系統(tǒng)
內(nèi)容說明: 本函數(shù)用來取得最后一次 yp 操作時的錯誤
[url=javascript:;]代碼[/url]
,代碼值及意義見下粗體部分
代碼 意義
1 函數(shù)的參數(shù)有錯
2 rpc 錯誤 - 不再系著 domain
3 在 domain 上無法系住服務(wù)器
4 domain 上找不到指定的 map
5 map 上找不到指定的索引鍵
6 yp 內(nèi)部有錯
7 資源取得錯誤
8 指定 map
[url=javascript:;]數(shù)據(jù)庫[/url]
中已無資料
9 無法與 portmapper 通訊
10 無法與 ypbind 通訊
11 無法與 ypserv 通訊
12 未配置本地的 domain
13 yp 數(shù)據(jù)庫有錯
14 yp 版本不合
15 暴力存取
16 資料忙線中
yp_err_string
取得先前 yp 操作的錯誤字符串。
語法: string yp_err_string(void);
返回值: 字符串
函數(shù)種類: 網(wǎng)絡(luò)系統(tǒng)
內(nèi)容說明: 本函數(shù)用來取得最后一次 yp 操作時的錯誤字符串。本函數(shù)不需參數(shù)。
【編輯推薦】