doc

[openssh.git] / pty.h

diff --git a/pty.h b/pty.h
index 1ade71745bf81ba140b13a3e21ed3b5658f7e512..c65f8c9302667fd71d5ae166a4cd75c4c237e0b5 100644 (file)
--- a/pty.h
+++ b/pty.h
@@ -18,18 +18,24 @@
 #ifndef PTY_H
 #define PTY_H
 
-/* Allocates and opens a pty.  Returns 0 if no pty could be allocated,
-   or nonzero if a pty was successfully allocated.  On success, open file
-   descriptors for the pty and tty sides and the name of the tty side are
-   returned (the buffer must be able to hold at least 64 characters). */
-int     pty_allocate(int *ptyfd, int *ttyfd, char *ttyname);
-
-/* Releases the tty.  Its ownership is returned to root, and permissions to
-   0666. */
+/*
+ * Allocates and opens a pty.  Returns 0 if no pty could be allocated, or
+ * nonzero if a pty was successfully allocated.  On success, open file
+ * descriptors for the pty and tty sides and the name of the tty side are
+ * returned (the buffer must be able to hold at least 64 characters).
+ */
+int     pty_allocate(int *ptyfd, int *ttyfd, char *ttyname, int ttynamelen);
+
+/*
+ * Releases the tty.  Its ownership is returned to root, and permissions to
+ * 0666.
+ */
 void    pty_release(const char *ttyname);
 
-/* Makes the tty the processes controlling tty and sets it to sane modes.
-   This may need to reopen the tty to get rid of possible eavesdroppers. */
+/*
+ * Makes the tty the processes controlling tty and sets it to sane modes.
+ * This may need to reopen the tty to get rid of possible eavesdroppers.
+ */
 void    pty_make_controlling_tty(int *ttyfd, const char *ttyname);
 
 /* Changes the window size associated with the pty. */
@@ -37,4 +43,6 @@ void
 pty_change_window_size(int ptyfd, int row, int col,
     int xpixel, int ypixel);
 
+void   pty_setowner(struct passwd *pw, const char *ttyname);
+
 #endif                         /* PTY_H */