pty.h

   1 /*
   2  *
   3  * pty.h
   4  *
   5  * Author: Tatu Ylonen <ylo@cs.hut.fi>
   6  *
   7  * Copyright (c) 1995 Tatu Ylonen <ylo@cs.hut.fi>, Espoo, Finland
   8  *                    All rights reserved
   9  *
  10  * Created: Fri Mar 17 05:03:28 1995 ylo
  11  *
  12  * Functions for allocating a pseudo-terminal and making it the controlling
  13  * tty.
  14  */
  15
  16 /* RCSID("$OpenBSD: pty.h,v 1.7 2000/06/20 01:39:43 markus Exp $"); */
  17
  18 #ifndef PTY_H
  19 #define PTY_H
  20
  21 /*
  22  * Allocates and opens a pty.  Returns 0 if no pty could be allocated, or
  23  * nonzero if a pty was successfully allocated.  On success, open file
  24  * descriptors for the pty and tty sides and the name of the tty side are
  25  * returned (the buffer must be able to hold at least 64 characters).
  26  */
  27 int     pty_allocate(int *ptyfd, int *ttyfd, char *ttyname, int ttynamelen);
  28
  29 /*
  30  * Releases the tty.  Its ownership is returned to root, and permissions to
  31  * 0666.
  32  */
  33 void    pty_release(const char *ttyname);
  34
  35 /*
  36  * Makes the tty the processes controlling tty and sets it to sane modes.
  37  * This may need to reopen the tty to get rid of possible eavesdroppers.
  38  */
  39 void    pty_make_controlling_tty(int *ttyfd, const char *ttyname);
  40
  41 /* Changes the window size associated with the pty. */
  42 void
  43 pty_change_window_size(int ptyfd, int row, int col,
  44     int xpixel, int ypixel);
  45
  46 void    pty_setowner(struct passwd *pw, const char *ttyname);
  47
  48 #endif                          /* PTY_H */