LOCAL(3R)

NAME
local - make the calling process local

SYNOPSIS
int local ( )

DESCRIPTION
The local function provides the application developer with the means to change the disposition of a process from the connected state (e.g. using a layers connection and host resources) to a local state. The host side processes are killed as if the process were deleted. However the terminal retains all local information and other resources that were requested through the request(3R) function. If the process does not own the KBD resource, typing on the keyboard will sound the bell.

When a process is made local, the border surrounding the process's window is changed to a checkered pattern to differentiate it with connected windows.

The local function will fail if the process is already local or is the last process connected to the host. Therefore, the local function will always fail if the process is operating in the non-layers environment which, by definition, supports only one host connection. A local function failure results in a zero value being returned. On success, a 1 is returned.

SEE ALSO
attach(3R), peel(3R).
layers(1) in UNIX System V Release 3 User's Reference Manual.
layers(1) in 5620 Dot-Mapped Display Reference Manual.