platform_bionic/libc/bionic/pty.cpp
Elliott Hughes fce3187088 Cleanup for #inclusivefixit.
This was initially just to try on "pty" and "tty" for size, while
discussing with other projects to try to align on vocabulary, but -- in
the implemention and tests at least -- but these work out so well that
I'm tempted to go with them anyway if we can't come to a concensus. We
can always come back and change them again later.

What I really like is that you pass the pty to functions like ptsname()
and grantpt() with a 'p' in the name, and the tty to functions like
ttyname() and tcsetattr() with just 't's.

The use of "parent" and "child" in forkpty() seems helpful too.

Also fix the documentation of forkpty(), which wasn't quite right.

Test: treehugger
Change-Id: Ic010c4b669f6528591c653e3701f4e41e0d0df9e
2020-07-28 12:12:20 -07:00

196 lines
4.3 KiB
C++

/*
* Copyright (C) 2008 The Android Open Source Project
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions
* are met:
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in
* the documentation and/or other materials provided with the
* distribution.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
* FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
* COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
* BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
* OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
* OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
* SUCH DAMAGE.
*/
#include <errno.h>
#include <fcntl.h>
#include <pty.h>
#include <stdio.h>
#include <stdlib.h>
#include <sys/ioctl.h>
#include <termios.h>
#include <unistd.h>
#include <utmp.h>
#include "bionic/pthread_internal.h"
#include "private/FdPath.h"
int getpt() {
return posix_openpt(O_RDWR|O_NOCTTY);
}
int grantpt(int) {
return 0;
}
int posix_openpt(int flags) {
return open("/dev/ptmx", flags);
}
char* ptsname(int fd) {
bionic_tls& tls = __get_bionic_tls();
char* buf = tls.ptsname_buf;
int error = ptsname_r(fd, buf, sizeof(tls.ptsname_buf));
return (error == 0) ? buf : nullptr;
}
int ptsname_r(int fd, char* buf, size_t len) {
if (buf == nullptr) {
errno = EINVAL;
return errno;
}
unsigned int pty_num;
if (ioctl(fd, TIOCGPTN, &pty_num) != 0) {
errno = ENOTTY;
return errno;
}
if (snprintf(buf, len, "/dev/pts/%u", pty_num) >= static_cast<int>(len)) {
errno = ERANGE;
return errno;
}
return 0;
}
char* ttyname(int fd) {
bionic_tls& tls = __get_bionic_tls();
char* buf = tls.ttyname_buf;
int error = ttyname_r(fd, buf, sizeof(tls.ttyname_buf));
return (error == 0) ? buf : nullptr;
}
int ttyname_r(int fd, char* buf, size_t len) {
if (buf == nullptr) {
errno = EINVAL;
return errno;
}
if (!isatty(fd)) {
return errno;
}
ssize_t count = readlink(FdPath(fd).c_str(), buf, len);
if (count == -1) {
return errno;
}
if (static_cast<size_t>(count) == len) {
errno = ERANGE;
return errno;
}
buf[count] = '\0';
return 0;
}
int unlockpt(int fd) {
int unlock = 0;
return ioctl(fd, TIOCSPTLCK, &unlock);
}
int openpty(int* pty, int* tty, char* name, const termios* t, const winsize* ws) {
*pty = getpt();
if (*pty == -1) {
return -1;
}
if (grantpt(*pty) == -1 || unlockpt(*pty) == -1) {
close(*pty);
return -1;
}
char buf[32];
if (name == nullptr) {
name = buf;
}
if (ptsname_r(*pty, name, sizeof(buf)) != 0) {
close(*pty);
return -1;
}
*tty = open(name, O_RDWR | O_NOCTTY);
if (*tty == -1) {
close(*pty);
return -1;
}
if (t != nullptr) {
tcsetattr(*tty, TCSAFLUSH, t);
}
if (ws != nullptr) {
ioctl(*tty, TIOCSWINSZ, ws);
}
return 0;
}
int forkpty(int* parent_pty, char* child_tty_name, const termios* t, const winsize* ws) {
int pty;
int tty;
if (openpty(&pty, &tty, child_tty_name, t, ws) == -1) {
return -1;
}
pid_t pid = fork();
if (pid == -1) {
close(pty);
close(tty);
return -1;
}
if (pid == 0) {
// Child.
*parent_pty = -1;
close(pty);
if (login_tty(tty) == -1) {
_exit(1);
}
return 0;
}
// Parent.
*parent_pty = pty;
close(tty);
return pid;
}
int login_tty(int fd) {
setsid();
if (ioctl(fd, TIOCSCTTY, nullptr) == -1) {
return -1;
}
dup2(fd, STDIN_FILENO);
dup2(fd, STDOUT_FILENO);
dup2(fd, STDERR_FILENO);
if (fd > STDERR_FILENO) {
close(fd);
}
return 0;
}