Annotation of researchv10dc/630/man/src/p_man/man3/local.3r, revision 1.1.1.1

1.1       root        1: .ds ZZ APPLICATION DEVELOPMENT PACKAGE
                      2: .TH LOCAL 3R "630 MTG"
                      3: .XE "local()"
                      4: .SH NAME
                      5: local \- make the calling process local
                      6: .SH SYNOPSIS
                      7: .ft B
                      8: int local ( )
                      9: .PP
                     10: .SH DESCRIPTION
                     11: The \fIlocal\fP function provides the application developer
                     12: with the means to change the disposition of a process from the
                     13: connected state (e.g. using a \f2layers\f1 connection and host resources)
                     14: to a local state. 
                     15: The host side processes are killed as if the process were
                     16: deleted. However the terminal retains all local information and
                     17: other resources that were requested through
                     18: the \f2request(3R)\f1 function.  If the process does not own
                     19: the KBD resource, typing on the keyboard will sound the
                     20: bell.
                     21: .PP
                     22: When a process is made local, the border
                     23: surrounding the process's window is changed to a checkered pattern
                     24: to differentiate it with connected windows.  
                     25: .PP
                     26: The \fIlocal\fP function will fail if the process is
                     27: already local or is the
                     28: last process connected to the host. Therefore,
                     29: the \fIlocal\fP function will always fail if the process is
                     30: operating in the non-layers environment which, by definition,
                     31: supports only one host connection. 
                     32: A \fIlocal\fP function failure results in a zero value being returned. On success,
                     33: a 1 is returned.
                     34: 
                     35: .SH SEE ALSO
                     36: attach(3R), peel(3R).
                     37: .br
                     38: layers(1) in \f2UNIX System V Release 3 User's Reference Manual\f1.
                     39: .br
                     40: layers(1) in \f25620 Dot-Mapped Display Reference Manual\f1.

unix.superglobalmegacorp.com

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