Annotation of 43BSDTahoe/new/xns/man/getcourierdbent.n, revision 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

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.