|
|
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.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.