Damien Miller | d4a8b7e | 1999-10-27 13:42:43 +1000 | [diff] [blame] | 1 | /* |
Damien Miller | 95def09 | 1999-11-25 00:26:21 +1100 | [diff] [blame] | 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 | */ |
Damien Miller | d4a8b7e | 1999-10-27 13:42:43 +1000 | [diff] [blame] | 15 | |
Damien Miller | b38eff8 | 2000-04-01 11:09:21 +1000 | [diff] [blame] | 16 | /* RCSID("$Id: pty.h,v 1.7 2000/04/01 01:09:25 damien Exp $"); */ |
Damien Miller | d4a8b7e | 1999-10-27 13:42:43 +1000 | [diff] [blame] | 17 | |
| 18 | #ifndef PTY_H |
| 19 | #define PTY_H |
| 20 | |
Damien Miller | 5428f64 | 1999-11-25 11:54:57 +1100 | [diff] [blame] | 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 | */ |
Damien Miller | 037a0dc | 1999-12-07 15:38:31 +1100 | [diff] [blame] | 27 | int pty_allocate(int *ptyfd, int *ttyfd, char *ttyname, int ttynamelen); |
Damien Miller | d4a8b7e | 1999-10-27 13:42:43 +1000 | [diff] [blame] | 28 | |
Damien Miller | 5428f64 | 1999-11-25 11:54:57 +1100 | [diff] [blame] | 29 | /* |
| 30 | * Releases the tty. Its ownership is returned to root, and permissions to |
| 31 | * 0666. |
| 32 | */ |
Damien Miller | 95def09 | 1999-11-25 00:26:21 +1100 | [diff] [blame] | 33 | void pty_release(const char *ttyname); |
Damien Miller | d4a8b7e | 1999-10-27 13:42:43 +1000 | [diff] [blame] | 34 | |
Damien Miller | 5428f64 | 1999-11-25 11:54:57 +1100 | [diff] [blame] | 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 | */ |
Damien Miller | 95def09 | 1999-11-25 00:26:21 +1100 | [diff] [blame] | 39 | void pty_make_controlling_tty(int *ttyfd, const char *ttyname); |
Damien Miller | d4a8b7e | 1999-10-27 13:42:43 +1000 | [diff] [blame] | 40 | |
| 41 | /* Changes the window size associated with the pty. */ |
Damien Miller | 95def09 | 1999-11-25 00:26:21 +1100 | [diff] [blame] | 42 | void |
| 43 | pty_change_window_size(int ptyfd, int row, int col, |
| 44 | int xpixel, int ypixel); |
Damien Miller | d4a8b7e | 1999-10-27 13:42:43 +1000 | [diff] [blame] | 45 | |
Damien Miller | c7d8dbb | 2000-03-02 23:30:53 +1100 | [diff] [blame] | 46 | void pty_setowner(struct passwd *pw, const char *ttyname); |
| 47 | |
Damien Miller | 95def09 | 1999-11-25 00:26:21 +1100 | [diff] [blame] | 48 | #endif /* PTY_H */ |