Return to getcourierdbent.n CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / xns / man

Annotation of 43BSDTahoe/new/xns/man/getcourierdbent.n, revision 1.1.1.1

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.