ZCOM C I/F Library Routines

ZLTMG (3X)

 

ZLTMG (3X)

NAME

zltmg – Move a logical terminal between groups

SYNOPSIS

#include

<zcom/zcomsys.h>

#include

<zcom/zcomcall.h> /* if compiled with ANSI C (recommended) */

int32 zltmg (zap, nap)

zaddr_type *zap;

zaddr_type *nap;

DESCRIPTION

Routine zltmg moves the logical terminal associated with a terminal

 

ZLU to a new group of logical terminals designated by another terminal

 

ZLU. The first terminal must not be the only terminal linked in its

 

existing group.

 

 

After a successful move, the moved terminal will be a member of the new

 

group, and its MUX, PORT, and physical terminal linkage are modified

 

to match the new group.

 

 

The libraries libzcom_c.a and libpthread.a must be linked into the calling

 

program by giving the options “-lzcom_c -lpthread” to cc(1) or ld(1).

Threads

This routine may be called from a multi-threaded application using the

Considerations

POSIX (1003.1c) kernel threads API package. This routine has the

 

following characteristics when called by a multi-threaded application:

 

cancellation point

Thread cancellation can occur when a thread

 

 

calls this routine.

 

async-cancel unsafe

The calling thread’s cancelability type must be

 

 

PTHREAD_CANCEL_DEFERRED if

 

 

cancellation is enabled.

 

async-signal unsafe

It cannot be called from a signal handler.

 

fork unsafe

It cannot be called by a child process after

 

 

fork(2) but before exec(2).

Chapter 4

243