Return to getcourierdbent.3 CVS log

Up to [CSRG BSD Unix] / 43BSD / contrib / xns / doc

Annotation of 43BSD/contrib/xns/doc/getcourierdbent.3, revision 1.1.1.1

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.