JAGENT(5)            INTERACTIVE UNIX System            JAGENT(5)



          NAME
               jagent - host control of windowing terminal

          SYNOPSIS
               #include <sys/jioctl.h>

               ioctl (cntlfd, JAGENT, &arg)

               int cntlfd
               struct bagent arg

          DESCRIPTION
               The ioctl(2) system call, when performed on an xt(7) device
               with the JAGENT request, allows a host program to send
               information to a windowing terminal.

               ioctl has three arguments:

               cntlfd    the xt(7) control channel file descriptor

               JAGENT    the xt(7) ioctl(2) request to invoke a windowing
                         terminal agent routine.

               arg       the address of a bagent structure, defined in
                         <sys/jioctl.h> as follows:

                         struct    bagent {
                           long  size;  /* size of src in & dest out */
                           char  *src;  /* the source byte string */
                           char  *dest; /* the destination byte string */
                         };

               The src pointer must be initialized to point to a byte
               string which is sent to the windowing terminal. See
               layers(5) for a list of JAGENT strings recognized by window-
               ing terminals.  Likewise, the dest pointer must be initial-
               ized to the address of a buffer to receive a byte string
               returned by the terminal.  When ioctl(2) is called, the size
               argument must be set to the length of the src string.  Upon
               return, size is set by ioctl(2) to the length of the desti-
               nation byte string, dest.

          SEE ALSO
               ioctl(2), libwindows(3X), layers(5).
               xt(7) in the INTERACTIVE UNIX System User's/System
               Administrator's Reference Manual.

          DIAGNOSTICS
               Upon successful completion, the size of the destination byte
               string is returned.  If an error occurs, -1 is returned.





          Rev. C Software Development Set                            Page 1