|
|
1.1 ! root 1: .TH GETCOURIERDBENT 3 "14 January 1985" ! 2: .SH NAME ! 3: getcourierdbent, getcourierservice, setcourierdbent, endcourierdbent \- ! 4: get courier service entry ! 5: .SH SYNOPSIS ! 6: .nf ! 7: .B #include <courier/courierdb.h> ! 8: .PP ! 9: .B struct courierdbent *getcourierdbent() ! 10: .PP ! 11: .B struct courierdbent *getcourierservice(program,version) ! 12: .B unsigned long program; ! 13: .B unsigned short version; ! 14: .PP ! 15: .B setcourierdbent() ! 16: .PP ! 17: .B endcourierdbent() ! 18: .fi ! 19: .SH DESCRIPTION ! 20: .I Getcourierdbent ! 21: and ! 22: .I getcourierservice ! 23: each return a pointer to an object with the ! 24: following structure ! 25: containing the broken-out ! 26: fields of a line in the Courier services file, describing one service ! 27: defined on this machine. ! 28: .RS ! 29: .PP ! 30: .nf ! 31: .so /usr/include/courier/courierdb.h ! 32: .ft R ! 33: .ad ! 34: .fi ! 35: .RE ! 36: .PP ! 37: Each entry describes one program contained in the database of Courier ! 38: programs known on this system. The ! 39: .I cr_description ! 40: field contains a pointer to a string containing the full path name of ! 41: the Courier description (used in DEPENDS UPON constructs from other ! 42: Courier descriptions. ! 43: The ! 44: .I cr_serverbin ! 45: contains either NULL to indicate that no server for this program exists, ! 46: or the full path name of the executable file which implements the ! 47: server. ! 48: .PP ! 49: .I Getcourierdbent ! 50: reads the next ! 51: line (opening the file if necessary); ! 52: .I setcourierdbent ! 53: rewinds the file; ! 54: .I endcourierdbent ! 55: closes it. ! 56: .PP ! 57: .I Getcourierservice ! 58: searches from the beginning until a matching ! 59: .I program ! 60: and ! 61: .I version ! 62: is found ! 63: (or until EOF is encountered). ! 64: .SH FILES ! 65: /etc/Courierservices ! 66: .SH "SEE ALSO" ! 67: Xerox courier specification. ! 68: .SH DIAGNOSTICS ! 69: Null pointer ! 70: (0) returned on EOF or error. ! 71: .SH BUGS ! 72: All information ! 73: is contained in a static area ! 74: so it must be copied if it is ! 75: to be saved. ! 76: .br
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.