dtcreateterm(3) [hpux man page]

DtCreateTerm(library call)												DtCreateTerm(library call)

NAME

       DtCreateTerm -- create a DtTerm widget

SYNOPSIS

       #include <Dt/Term.h>
       Widget DtCreateTerm(
       Widget parent,
       String name,
       ArgList arglist,
       Cardinal argcount);

DESCRIPTION

       The DtCreateTerm function creates a terminal emulator widget hierarchy.

       The parent argument specifies the parent widget ID.

       The name argument specifies the name of the created widget.

       The arglist argument specifies the argument list.

       The argcount argument specifies the number of attribute and value pairs in the argument list (arglist).

       The DtTerm widget provides the core set of functionality needed to emulate an ANSI X3.64-1979- and ISO 6429:1992(E)-style terminal, such as
       the DEC VT220.  This functionality includes text rendering, scrolling, margin and tab support, escape sequence parsing  and  the  low-level
       OS-specific interface required to allocate and configure a pty or STREAMS pseudo-terminal device and write the system's utmp device.

RETURN VALUE

       Upon successful completion, the DtCreateTerm function returns the DtTerm widget ID.

SEE ALSO

       dtterm(1), dtterm(5), pty(7), Dt/Term.h - DtTerm(5), DtTerm(3), DtTermInitialize(3), DtTermDisplaySend(3), DtTermSubprocSend(3), DtTermSub-
       procReap(3).

															DtCreateTerm(library call)

DtTermSubprocReap(library call) 										   DtTermSubprocReap(library call)

NAME

       DtTermSubprocReap -- allow a DtTerm widget to clean up after subprocess termination

SYNOPSIS

       #include <Dt/Term.h>
       void DtTermSubprocReap(
       pid_t pid,
       int *stat_loc);

DESCRIPTION

       The DtTermSubprocReap function allows DtTerm widgets to function correctly in applications that have installed a SIGCHLD signal handler.

       The pid argument specifies the process ID of the child process wait(2) returns.

       The stat_loc argument specifies the termination information wait(2) returns.

RETURN VALUES

       The DtTermSubprocReap function returns no value.

APPLICATION USAGE

       The DtTermSubprocReap function allows an application to install its own SIGCHLD signal handler.

       The application must install its own SIGCHILD signal handler and call DtTermSubprocReap if the DtTerm widget was created with the DtSubpro-
       cessTerminatorCatch resource set to False.

       The application must call the DtTermSubprocReap function after performing a wait(2) (or associated function) on a terminated child process.
       If the child process is associated with a DtTerm widget, the widget's data structures are cleaned up and the associated callbacks invoked.

SEE ALSO

       Dt/Term.h - DtTerm(5), DtTerm(3), signal(5), wait(2).

														   DtTermSubprocReap(library call)