Return to attach.3r CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / p_man / man3

Annotation of researchv10dc/630/man/src/p_man/man3/attach.3r, revision 1.1

1.1     ! root        1: .ds ZZ DEVELOPMENT PACKAGE
        !             2: .TH ATTACH 3R "630 MTG"
        !             3: .XE "attach()"
        !             4: .SH NAME
        !             5: attach \- connect process to host
        !             6: .SH SYNOPSIS
        !             7: .B int attach (host)
        !             8: .br
        !             9: .B int host;
        !            10: .SH DESCRIPTION
        !            11: A process that is already local may connect itself to a
        !            12: host by calling the function \fIattach\fP.  It takes a
        !            13: single argument indicating the host to be connected to. 
        !            14: There are currently only two valid values, 0 and 1, that
        !            15: refer to logical Host 1
        !            16: and Host 2, respectively.  When a process is successfully
        !            17: attached, the border for the window of that process becomes solid.
        !            18: .PP
        !            19: The resources owned by the process remain unchanged except for
        !            20: the addition of a host connection.  The \fIattach\fP function operates
        !            21: correctly independent of whether the host is already in \fBlayers\fR
        !            22: mode or not.
        !            23: .PP
        !            24: The function can fail if the host has not been configured in the
        !            25: set-up options; if there are not any available connections for the
        !            26: specified host; if the process is already connected;
        !            27: or if the host argument is invalid.  A failure
        !            28: is indicated to the calling process by a return value of zero.
        !            29: 
        !            30: .SH EXAMPLE
        !            31: This example shows how the \fIattach\fP function may be used in
        !            32: a process that wishes to be connected
        !            33: to the logical Host 2.
        !            34: .PP
        !            35: .RS 3
        !            36: .nf
        !            37: .ft CM
        !            38: #include <dmd.h>
        !            39: 
        !            40: 
        !            41: switchhost ()
        !            42: {
        !            43:        if (local())
        !            44:                attach(1);
        !            45:        
        !            46: }
        !            47: \fR
        !            48: .fi
        !            49: .RE
        !            50: .SH SEE ALSO
        !            51: local(3R), peel(3R).
        !            52: .SH WARNING
        !            53: The host values may change in meaning and/or be expanded in the future.

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