1 // SPDX-License-Identifier: GPL-2.0
3 * Copyright (C) 1991, 1992 Linus Torvalds
6 #include <linux/types.h>
7 #include <linux/errno.h>
8 #include <linux/signal.h>
9 #include <linux/sched/signal.h>
10 #include <linux/sched/task.h>
11 #include <linux/tty.h>
12 #include <linux/fcntl.h>
13 #include <linux/uaccess.h>
16 static int is_ignored(int sig
)
18 return (sigismember(¤t
->blocked
, sig
) ||
19 current
->sighand
->action
[sig
-1].sa
.sa_handler
== SIG_IGN
);
23 * __tty_check_change - check for POSIX terminal changes
25 * @sig: signal to send
27 * If we try to write to, or set the state of, a terminal and we're
28 * not in the foreground, send a SIGTTOU. If the signal is blocked or
29 * ignored, go ahead and perform the operation. (POSIX 7.2)
33 int __tty_check_change(struct tty_struct
*tty
, int sig
)
36 struct pid
*pgrp
, *tty_pgrp
;
39 if (current
->signal
->tty
!= tty
)
43 pgrp
= task_pgrp(current
);
45 spin_lock_irqsave(&tty
->ctrl
.lock
, flags
);
46 tty_pgrp
= tty
->ctrl
.pgrp
;
47 spin_unlock_irqrestore(&tty
->ctrl
.lock
, flags
);
49 if (tty_pgrp
&& pgrp
!= tty_pgrp
) {
50 if (is_ignored(sig
)) {
53 } else if (is_current_pgrp_orphaned())
56 kill_pgrp(pgrp
, sig
, 1);
57 set_thread_flag(TIF_SIGPENDING
);
64 tty_warn(tty
, "sig=%d, tty->pgrp == NULL!\n", sig
);
69 int tty_check_change(struct tty_struct
*tty
)
71 return __tty_check_change(tty
, SIGTTOU
);
73 EXPORT_SYMBOL(tty_check_change
);
75 void proc_clear_tty(struct task_struct
*p
)
78 struct tty_struct
*tty
;
80 spin_lock_irqsave(&p
->sighand
->siglock
, flags
);
82 p
->signal
->tty
= NULL
;
83 spin_unlock_irqrestore(&p
->sighand
->siglock
, flags
);
88 * __proc_set_tty - set the controlling terminal
91 * Only callable by the session leader and only if it does not already have
92 * a controlling terminal.
94 * Caller must hold: tty_lock()
95 * a readlock on tasklist_lock
98 static void __proc_set_tty(struct tty_struct
*tty
)
102 spin_lock_irqsave(&tty
->ctrl
.lock
, flags
);
104 * The session and fg pgrp references will be non-NULL if
105 * tiocsctty() is stealing the controlling tty
107 put_pid(tty
->ctrl
.session
);
108 put_pid(tty
->ctrl
.pgrp
);
109 tty
->ctrl
.pgrp
= get_pid(task_pgrp(current
));
110 tty
->ctrl
.session
= get_pid(task_session(current
));
111 spin_unlock_irqrestore(&tty
->ctrl
.lock
, flags
);
112 if (current
->signal
->tty
) {
113 tty_debug(tty
, "current tty %s not NULL!!\n",
114 current
->signal
->tty
->name
);
115 tty_kref_put(current
->signal
->tty
);
117 put_pid(current
->signal
->tty_old_pgrp
);
118 current
->signal
->tty
= tty_kref_get(tty
);
119 current
->signal
->tty_old_pgrp
= NULL
;
122 static void proc_set_tty(struct tty_struct
*tty
)
124 spin_lock_irq(¤t
->sighand
->siglock
);
126 spin_unlock_irq(¤t
->sighand
->siglock
);
130 * Called by tty_open() to set the controlling tty if applicable.
132 void tty_open_proc_set_tty(struct file
*filp
, struct tty_struct
*tty
)
134 read_lock(&tasklist_lock
);
135 spin_lock_irq(¤t
->sighand
->siglock
);
136 if (current
->signal
->leader
&&
137 !current
->signal
->tty
&&
138 tty
->ctrl
.session
== NULL
) {
140 * Don't let a process that only has write access to the tty
141 * obtain the privileges associated with having a tty as
142 * controlling terminal (being able to reopen it with full
143 * access through /dev/tty, being able to perform pushback).
144 * Many distributions set the group of all ttys to "tty" and
145 * grant write-only access to all terminals for setgid tty
146 * binaries, which should not imply full privileges on all ttys.
148 * This could theoretically break old code that performs open()
149 * on a write-only file descriptor. In that case, it might be
150 * necessary to also permit this if
151 * inode_permission(inode, MAY_READ) == 0.
153 if (filp
->f_mode
& FMODE_READ
)
156 spin_unlock_irq(¤t
->sighand
->siglock
);
157 read_unlock(&tasklist_lock
);
160 struct tty_struct
*get_current_tty(void)
162 struct tty_struct
*tty
;
165 spin_lock_irqsave(¤t
->sighand
->siglock
, flags
);
166 tty
= tty_kref_get(current
->signal
->tty
);
167 spin_unlock_irqrestore(¤t
->sighand
->siglock
, flags
);
170 EXPORT_SYMBOL_GPL(get_current_tty
);
173 * Called from tty_release().
175 void session_clear_tty(struct pid
*session
)
177 struct task_struct
*p
;
179 do_each_pid_task(session
, PIDTYPE_SID
, p
) {
181 } while_each_pid_task(session
, PIDTYPE_SID
, p
);
185 * tty_signal_session_leader - sends SIGHUP to session leader
186 * @tty: controlling tty
187 * @exit_session: if non-zero, signal all foreground group processes
189 * Send SIGHUP and SIGCONT to the session leader and its process group.
190 * Optionally, signal all processes in the foreground process group.
192 * Returns the number of processes in the session with this tty
193 * as their controlling terminal. This value is used to drop
194 * tty references for those processes.
196 int tty_signal_session_leader(struct tty_struct
*tty
, int exit_session
)
198 struct task_struct
*p
;
200 struct pid
*tty_pgrp
= NULL
;
202 read_lock(&tasklist_lock
);
203 if (tty
->ctrl
.session
) {
204 do_each_pid_task(tty
->ctrl
.session
, PIDTYPE_SID
, p
) {
205 spin_lock_irq(&p
->sighand
->siglock
);
206 if (p
->signal
->tty
== tty
) {
207 p
->signal
->tty
= NULL
;
209 * We defer the dereferences outside of
214 if (!p
->signal
->leader
) {
215 spin_unlock_irq(&p
->sighand
->siglock
);
218 send_signal_locked(SIGHUP
, SEND_SIG_PRIV
, p
, PIDTYPE_TGID
);
219 send_signal_locked(SIGCONT
, SEND_SIG_PRIV
, p
, PIDTYPE_TGID
);
220 put_pid(p
->signal
->tty_old_pgrp
); /* A noop */
221 spin_lock(&tty
->ctrl
.lock
);
222 tty_pgrp
= get_pid(tty
->ctrl
.pgrp
);
224 p
->signal
->tty_old_pgrp
=
225 get_pid(tty
->ctrl
.pgrp
);
226 spin_unlock(&tty
->ctrl
.lock
);
227 spin_unlock_irq(&p
->sighand
->siglock
);
228 } while_each_pid_task(tty
->ctrl
.session
, PIDTYPE_SID
, p
);
230 read_unlock(&tasklist_lock
);
234 kill_pgrp(tty_pgrp
, SIGHUP
, exit_session
);
242 * disassociate_ctty - disconnect controlling tty
243 * @on_exit: true if exiting so need to "hang up" the session
245 * This function is typically called only by the session leader, when
246 * it wants to disassociate itself from its controlling tty.
248 * It performs the following functions:
249 * (1) Sends a SIGHUP and SIGCONT to the foreground process group
250 * (2) Clears the tty from being controlling the session
251 * (3) Clears the controlling tty for all processes in the
254 * The argument on_exit is set to 1 if called when a process is
255 * exiting; it is 0 if called by the ioctl TIOCNOTTY.
258 * BTM is taken for hysterical raisons, and held when
259 * called from no_tty().
260 * tty_mutex is taken to protect tty
261 * ->siglock is taken to protect ->signal/->sighand
262 * tasklist_lock is taken to walk process list for sessions
263 * ->siglock is taken to protect ->signal/->sighand
265 void disassociate_ctty(int on_exit
)
267 struct tty_struct
*tty
;
269 if (!current
->signal
->leader
)
272 tty
= get_current_tty();
274 if (on_exit
&& tty
->driver
->type
!= TTY_DRIVER_TYPE_PTY
) {
275 tty_vhangup_session(tty
);
277 struct pid
*tty_pgrp
= tty_get_pgrp(tty
);
280 kill_pgrp(tty_pgrp
, SIGHUP
, on_exit
);
282 kill_pgrp(tty_pgrp
, SIGCONT
, on_exit
);
288 } else if (on_exit
) {
289 struct pid
*old_pgrp
;
291 spin_lock_irq(¤t
->sighand
->siglock
);
292 old_pgrp
= current
->signal
->tty_old_pgrp
;
293 current
->signal
->tty_old_pgrp
= NULL
;
294 spin_unlock_irq(¤t
->sighand
->siglock
);
296 kill_pgrp(old_pgrp
, SIGHUP
, on_exit
);
297 kill_pgrp(old_pgrp
, SIGCONT
, on_exit
);
303 tty
= get_current_tty();
308 spin_lock_irqsave(&tty
->ctrl
.lock
, flags
);
309 put_pid(tty
->ctrl
.session
);
310 put_pid(tty
->ctrl
.pgrp
);
311 tty
->ctrl
.session
= NULL
;
312 tty
->ctrl
.pgrp
= NULL
;
313 spin_unlock_irqrestore(&tty
->ctrl
.lock
, flags
);
318 /* If tty->ctrl.pgrp is not NULL, it may be assigned to
319 * current->signal->tty_old_pgrp in a race condition, and
320 * cause pid memleak. Release current->signal->tty_old_pgrp
321 * after tty->ctrl.pgrp set to NULL.
323 spin_lock_irq(¤t
->sighand
->siglock
);
324 put_pid(current
->signal
->tty_old_pgrp
);
325 current
->signal
->tty_old_pgrp
= NULL
;
326 spin_unlock_irq(¤t
->sighand
->siglock
);
328 /* Now clear signal->tty under the lock */
329 read_lock(&tasklist_lock
);
330 session_clear_tty(task_session(current
));
331 read_unlock(&tasklist_lock
);
336 * no_tty - Ensure the current process does not have a controlling tty
341 * FIXME: Review locking here. The tty_lock never covered any race
342 * between a new association and proc_clear_tty but possibly we need
343 * to protect against this anyway.
345 struct task_struct
*tsk
= current
;
347 disassociate_ctty(0);
352 * tiocsctty - set controlling tty
353 * @tty: tty structure
354 * @file: file structure used to check permissions
355 * @arg: user argument
357 * This ioctl is used to manage job control. It permits a session
358 * leader to set this tty as the controlling tty for the session.
361 * Takes tty_lock() to serialize proc_set_tty() for this tty
362 * Takes tasklist_lock internally to walk sessions
363 * Takes ->siglock() when updating signal->tty
365 static int tiocsctty(struct tty_struct
*tty
, struct file
*file
, int arg
)
370 read_lock(&tasklist_lock
);
372 if (current
->signal
->leader
&&
373 task_session(current
) == tty
->ctrl
.session
)
377 * The process must be a session leader and
378 * not have a controlling tty already.
380 if (!current
->signal
->leader
|| current
->signal
->tty
) {
385 if (tty
->ctrl
.session
) {
387 * This tty is already the controlling
388 * tty for another session group!
390 if (arg
== 1 && capable(CAP_SYS_ADMIN
)) {
394 session_clear_tty(tty
->ctrl
.session
);
401 /* See the comment in tty_open_proc_set_tty(). */
402 if ((file
->f_mode
& FMODE_READ
) == 0 && !capable(CAP_SYS_ADMIN
)) {
409 read_unlock(&tasklist_lock
);
415 * tty_get_pgrp - return a ref counted pgrp pid
418 * Returns a refcounted instance of the pid struct for the process
419 * group controlling the tty.
421 struct pid
*tty_get_pgrp(struct tty_struct
*tty
)
426 spin_lock_irqsave(&tty
->ctrl
.lock
, flags
);
427 pgrp
= get_pid(tty
->ctrl
.pgrp
);
428 spin_unlock_irqrestore(&tty
->ctrl
.lock
, flags
);
432 EXPORT_SYMBOL_GPL(tty_get_pgrp
);
435 * This checks not only the pgrp, but falls back on the pid if no
436 * satisfactory pgrp is found. I dunno - gdb doesn't work correctly
439 * The caller must hold rcu lock or the tasklist lock.
441 static struct pid
*session_of_pgrp(struct pid
*pgrp
)
443 struct task_struct
*p
;
444 struct pid
*sid
= NULL
;
446 p
= pid_task(pgrp
, PIDTYPE_PGID
);
448 p
= pid_task(pgrp
, PIDTYPE_PID
);
450 sid
= task_session(p
);
456 * tiocgpgrp - get process group
457 * @tty: tty passed by user
458 * @real_tty: tty side of the tty passed by the user if a pty else the tty
461 * Obtain the process group of the tty. If there is no process group
464 * Locking: none. Reference to current->signal->tty is safe.
466 static int tiocgpgrp(struct tty_struct
*tty
, struct tty_struct
*real_tty
, pid_t __user
*p
)
471 * (tty == real_tty) is a cheap way of
472 * testing if the tty is NOT a master pty.
474 if (tty
== real_tty
&& current
->signal
->tty
!= real_tty
)
476 pid
= tty_get_pgrp(real_tty
);
477 ret
= put_user(pid_vnr(pid
), p
);
483 * tiocspgrp - attempt to set process group
484 * @tty: tty passed by user
485 * @real_tty: tty side device matching tty passed by user
488 * Set the process group of the tty to the session passed. Only
489 * permitted where the tty session is our session.
491 * Locking: RCU, ctrl lock
493 static int tiocspgrp(struct tty_struct
*tty
, struct tty_struct
*real_tty
, pid_t __user
*p
)
497 int retval
= tty_check_change(real_tty
);
504 if (get_user(pgrp_nr
, p
))
509 spin_lock_irq(&real_tty
->ctrl
.lock
);
510 if (!current
->signal
->tty
||
511 (current
->signal
->tty
!= real_tty
) ||
512 (real_tty
->ctrl
.session
!= task_session(current
))) {
514 goto out_unlock_ctrl
;
517 pgrp
= find_vpid(pgrp_nr
);
522 if (session_of_pgrp(pgrp
) != task_session(current
))
525 put_pid(real_tty
->ctrl
.pgrp
);
526 real_tty
->ctrl
.pgrp
= get_pid(pgrp
);
530 spin_unlock_irq(&real_tty
->ctrl
.lock
);
535 * tiocgsid - get session id
536 * @tty: tty passed by user
537 * @real_tty: tty side of the tty passed by the user if a pty else the tty
538 * @p: pointer to returned session id
540 * Obtain the session id of the tty. If there is no session
543 static int tiocgsid(struct tty_struct
*tty
, struct tty_struct
*real_tty
, pid_t __user
*p
)
549 * (tty == real_tty) is a cheap way of
550 * testing if the tty is NOT a master pty.
552 if (tty
== real_tty
&& current
->signal
->tty
!= real_tty
)
555 spin_lock_irqsave(&real_tty
->ctrl
.lock
, flags
);
556 if (!real_tty
->ctrl
.session
)
558 sid
= pid_vnr(real_tty
->ctrl
.session
);
559 spin_unlock_irqrestore(&real_tty
->ctrl
.lock
, flags
);
561 return put_user(sid
, p
);
564 spin_unlock_irqrestore(&real_tty
->ctrl
.lock
, flags
);
569 * Called from tty_ioctl(). If tty is a pty then real_tty is the slave side,
570 * if not then tty == real_tty.
572 long tty_jobctrl_ioctl(struct tty_struct
*tty
, struct tty_struct
*real_tty
,
573 struct file
*file
, unsigned int cmd
, unsigned long arg
)
575 void __user
*p
= (void __user
*)arg
;
579 if (current
->signal
->tty
!= tty
)
584 return tiocsctty(real_tty
, file
, arg
);
586 return tiocgpgrp(tty
, real_tty
, p
);
588 return tiocspgrp(tty
, real_tty
, p
);
590 return tiocgsid(tty
, real_tty
, p
);