Return to connld.4 CVS log

Up to [Research Unix] / researchv10dc / man / man4

Annotation of researchv10dc/man/man4/connld.4, revision 1.1.1.1

1.1       root        1: .TH CONNLD 4
                      2: .CT 2 sa comm_proc
                      3: .SH NAME
                      4: conn_ld \- line discipline for unique stream connection
                      5: .SH SYNOPSIS
                      6: .B #include <sys/filio.h>
                      7: .SH DESCRIPTION
                      8: This line discipline
                      9: provides unique connections
                     10: to a server.
                     11: The server process should push the line discipline on a pipe
                     12: (see
                     13: .B FIOPUSHLD 
                     14: in
                     15: .IR stream (4))
                     16: and
                     17: .IR fmount (2)
                     18: the pipe end on a file.
                     19: A subsequent attempt to
                     20: .IR open (2)
                     21: or
                     22: .IR creat
                     23: that file causes a new pipe to be created.
                     24: A file descriptor for one
                     25: end of the new pipe is passed on the mounted pipe to
                     26: to the server process as if by
                     27: .BR FIOSNDFD ;
                     28: see
                     29: .IR stream (4).
                     30: The
                     31: opening process
                     32: is blocked until the server responds.
                     33: The server should receive the passed file descriptor with
                     34: .RB FIORCVFD
                     35: and respond in one of the following ways:
                     36: .IP \(em
                     37: Accept the new file descriptor by performing
                     38: .RS
                     39: .IP
                     40: .L
                     41: ioctl(fd, FIOACCEPT, (void *)0);
                     42: .RE
                     43: .IP
                     44: The originating
                     45: .I open
                     46: completes and returns a file descriptor for the 
                     47: other end of the new pipe.
                     48: .IP \(em
                     49: Write some data on the new file descriptor.
                     50: This performs an implicit
                     51: .LR FIOACCEPT .
                     52: .IP \(em
                     53: Pass a different file descriptor:
                     54: .RS
                     55: .IP
                     56: .L
                     57: ioctl(fd, FIOSNDFD, &newfd);
                     58: .RE
                     59: .IP
                     60: The originator's end of the new pipe is closed,
                     61: and a file descriptor for the open file
                     62: designated by
                     63: .I newfd
                     64: is returned to the originating
                     65: .IR open .
                     66: .IP \(em
                     67: Reject the connection,
                     68: by closing the new file descriptor
                     69: or by performing
                     70: .RS
                     71: .IP
                     72: .L
                     73: ioctl(fd, FIOREJECT, (void *)0);
                     74: .RE
                     75: .IP
                     76: The originating
                     77: .I open
                     78: fails with
                     79: .BR ENXIO 
                     80: and the new pipe is discarded.
                     81: .SH SEE ALSO
                     82: .IR fmount (2),
                     83: .IR stream (4)

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