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