]>
git.saurik.com Git - apple/xnu.git/blob - bsd/kern/tty_compat.c
4bd2d02730424bb09e1c9cbf1801608503eb7914
2 * Copyright (c) 2000 Apple Computer, Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
28 /* Copyright (c) 1997 Apple Computer, Inc. All Rights Reserved */
30 * Copyright (c) 1982, 1986, 1991, 1993
31 * The Regents of the University of California. All rights reserved.
33 * Redistribution and use in source and binary forms, with or without
34 * modification, are permitted provided that the following conditions
36 * 1. Redistributions of source code must retain the above copyright
37 * notice, this list of conditions and the following disclaimer.
38 * 2. Redistributions in binary form must reproduce the above copyright
39 * notice, this list of conditions and the following disclaimer in the
40 * documentation and/or other materials provided with the distribution.
41 * 3. All advertising materials mentioning features or use of this software
42 * must display the following acknowledgement:
43 * This product includes software developed by the University of
44 * California, Berkeley and its contributors.
45 * 4. Neither the name of the University nor the names of its contributors
46 * may be used to endorse or promote products derived from this software
47 * without specific prior written permission.
49 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
50 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
51 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
52 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
53 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
54 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
55 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
56 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
57 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
58 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
61 * @(#)tty_compat.c 8.1 (Berkeley) 6/10/93
65 * Compatibility routines for BSD 4.3 tty ioctl() commands
67 * The only function externalized from this file is ttcompat() and it is
68 * externalized as private extern to prevent exporting of the symbol when
69 * KEXTs link against the kernel.
71 * Locks: All functions in this file assume that the tty_lock()
72 * is held on the tty structure before these functions are
76 #include <sys/param.h>
77 #include <sys/systm.h>
78 #include <sys/ioctl.h>
79 #include <sys/proc_internal.h>
81 #include <sys/termios.h>
82 #include <sys/file_internal.h>
84 #include <sys/kernel.h>
85 #include <sys/sysctl.h>
86 #include <sys/syslog.h>
88 static int ttcompatgetflags(struct tty
*tp
);
89 static void ttcompatsetflags(struct tty
*tp
, struct termios
*t
);
90 static void ttcompatsetlflags(struct tty
*tp
, struct termios
*t
);
91 static int ttcompatspeedtab(int speed
, struct speedtab
*table
);
94 * These two tables encode baud rate to speed code and speed code to
95 * baud rate information. They are a mapping between the <sys/termios.h>
96 * baud rate constants and the <sys/ttydev.h> baud rate constants. We
97 * cannot use those constants directly here because they occupy the same
100 static struct speedtab compatspeeds
[] = {
122 static int compatspcodes
[] = {
123 0, 50, 75, 110, 134, 150, 200, 300, 600, 1200,
124 1800, 2400, 4800, 9600, 19200, 38400, 57600, 115200,
130 * Description: Given a baud rate value as an integer, and a speed table,
131 * convert the baud rate to a speed code, according to the
132 * contents of the table. This effectively changes termios.h
133 * baud rate values into ttydev.h baud rate codes.
135 * Parameters: int speed Baud rate, as an integer
136 * struct speedtab *table Baud rate table to speed code table
138 * Returns: 1 B50 speed code; returned if we can
139 * not find an answer in the table.
140 * 0 If a 0 was requested in order to
141 * trigger a hangup (250ms of line
142 * silence, per Bell 103C standard).
143 * * A speed code matching the requested
144 * baud rate (potentially rounded down,
145 * if there is no exact match).
147 * Notes: This function is used for TIOCGETP, TIOCSETP, and TIOCSETN.
150 ttcompatspeedtab(int speed
, struct speedtab
*table
)
153 return 0; /* hangup */
155 for (; table
->sp_speed
> 0; table
++) {
156 if (table
->sp_speed
<= speed
) { /* nearest one, rounded down */
157 return table
->sp_code
;
160 return 1; /* 50, min and not hangup */
167 * Description: Convert backward compatability set command arguments as
170 * TIOCSETP -> TIOSETAF
171 * TIOCSETN -> TIOCSETA
172 * TIOCSETC -> TIOCSETA
173 * TIOCSLTC -> TIOCSETA
174 * TIOCLBIS -> TIOCSETA
175 * TIOCLBIC -> TIOCSETA
176 * TIOCLSET -> TIOCSETA
178 * The converted command argument and potentially modified 'term'
179 * argument are returned to ttcompat(), which will then call
180 * ttioctl_locked(), if this function returns successfully.
182 * Parameters struct tty *tp The tty on which the operation is
184 * u_long *com A pointer to the terminal input/output
185 * command being requested; its contents
186 * will be modified per the table above,
187 * on a non-error return.
188 * caddr_t data Command specific parameter data; this
189 * data is read but not modified.
190 * struct termios *term A local stack termios structure from
191 * ttcompat(), whose contents are to be
192 * modified based on *com and *data.
194 * Returns: EINVAL An input speed or output speed is
195 * outside the allowable range for a
196 * TIOCSETP or TIOCSETN command.
197 * 0 All other cases return 0.
199 * Notes: This function may modify the contents of the tp->t_flags
200 * field in a successful call to TIOCSETP, TIOCSETN, TIOCLBIS,
201 * TIOCLBIC, or TIOCLSET.
203 * All other tp fields will remain unmodifed, since the struct
204 * termios is a local stack copy from ttcompat(), and not the
205 * real thing. A subsequent call to ttioctl_locked() in
206 * ttcompat(), however, may result in subsequent changes.
208 * WARNING: This compatibility code is not 6/432 clean; it will only
209 * work for 32 bit processes on 32 bit kernels or 64 bit
210 * processes on 64 bit kernels. We are not addressing this
211 * due to <rdar://6904053>.
214 ttsetcompat(struct tty
*tp
, u_long
*com
, caddr_t data
, struct termios
*term
)
219 * Wait for all characters queued for output to drain, then
220 * Discard all characters queued for input, and then set
221 * the input and output speeds and device flags, per the
222 * contents of the struct sgttyb that 'data' points to.
226 * Same as TIOCSETP, but the output is not drained, and any
227 * pending input is not discarded.
230 struct sgttyb
*sg
= (struct sgttyb
*)data
;
233 if ((speed
= sg
->sg_ispeed
) > MAX_SPEED
|| speed
< 0) {
235 } else if (speed
!= ttcompatspeedtab(tp
->t_ispeed
, compatspeeds
)) {
236 term
->c_ispeed
= compatspcodes
[speed
];
238 term
->c_ispeed
= tp
->t_ispeed
;
240 if ((speed
= sg
->sg_ospeed
) > MAX_SPEED
|| speed
< 0) {
242 } else if (speed
!= ttcompatspeedtab(tp
->t_ospeed
, compatspeeds
)) {
243 term
->c_ospeed
= compatspcodes
[speed
];
245 term
->c_ospeed
= tp
->t_ospeed
;
247 term
->c_cc
[VERASE
] = sg
->sg_erase
;
248 term
->c_cc
[VKILL
] = sg
->sg_kill
;
249 tp
->t_flags
= (tp
->t_flags
& 0xffff0000) | (sg
->sg_flags
& 0xffff);
250 ttcompatsetflags(tp
, term
);
251 *com
= (*com
== TIOCSETP
) ? TIOCSETAF
: TIOCSETA
;
256 * Set the terminal control characters per the contents of
257 * the struct tchars that 'data' points to.
260 struct tchars
*tc
= (struct tchars
*)data
;
264 cc
[VINTR
] = tc
->t_intrc
;
265 cc
[VQUIT
] = tc
->t_quitc
;
266 cc
[VSTART
] = tc
->t_startc
;
267 cc
[VSTOP
] = tc
->t_stopc
;
268 cc
[VEOF
] = tc
->t_eofc
;
269 cc
[VEOL
] = tc
->t_brkc
;
270 if (tc
->t_brkc
== -1) {
271 cc
[VEOL2
] = _POSIX_VDISABLE
;
278 * Set the terminal control characters per the contents of
279 * the struct ltchars that 'data' points to.
282 struct ltchars
*ltc
= (struct ltchars
*)data
;
286 cc
[VSUSP
] = ltc
->t_suspc
;
287 cc
[VDSUSP
] = ltc
->t_dsuspc
;
288 cc
[VREPRINT
] = ltc
->t_rprntc
;
289 cc
[VDISCARD
] = ltc
->t_flushc
;
290 cc
[VWERASE
] = ltc
->t_werasc
;
291 cc
[VLNEXT
] = ltc
->t_lnextc
;
297 * Set the bits in the terminal state local flags word
298 * (16 bits) for the terminal to the current bits OR
299 * those in the 16 bit value pointed to by 'data'.
303 * Clear the bits in the terminal state local flags word
304 * for the terminal to the current bits AND those bits NOT
305 * in the 16 bit value pointed to by 'data'.
309 * Set the terminal state local flags word to exactly those
310 * bits that correspond to the 16 bit value pointed to by
313 if (*com
== TIOCLSET
) {
314 tp
->t_flags
= (tp
->t_flags
& 0xffff) | *(int *)data
<< 16;
317 (ttcompatgetflags(tp
) & 0xffff0000) | (tp
->t_flags
& 0xffff);
318 if (*com
== TIOCLBIS
) {
319 tp
->t_flags
|= *(int *)data
<< 16;
321 tp
->t_flags
&= ~(*(int *)data
<< 16);
324 ttcompatsetlflags(tp
, term
);
334 * Description: For 'set' commands, convert the command and arguments as
335 * necessary, and call ttioctl_locked(), returning the result
336 * as our result; for 'get' commands, obtain the requested data
337 * from the appropriate source, and return it in the expected
338 * format. If the command is not recognized, return EINVAL.
340 * Parameters struct tty *tp The tty on which the operation is
342 * u_long com The terminal input/output command
344 * caddr_t data The pointer to the user data argument
345 * provided with the command.
346 * int flag The file open flags (e.g. FREAD).
347 * struct proc *p The current process pointer for the
350 * Returns: 0 Most 'get' operations can't fail, and
351 * therefore return this.
352 * ENOTTY TIOCGSID may return this when you
353 * attempt to get the session ID for a
354 * terminal with no associated session,
355 * or for which there is a session, but
357 * ENOTTY If the command cannot be handled at
358 * this layer, this will be returned.
359 * * Any value returned by ttioctl_locked(),
360 * if a set command is requested.
362 * Notes: The process pointer may be a proxy on whose behalf we are
363 * operating, so it is not safe to simply use current_process()
367 __private_extern__
int
368 ttcompat(struct tty
*tp
, u_long com
, caddr_t data
, int flag
, struct proc
*p
)
379 * See ttsetcompat() for a full description of these command
380 * values and their meanings.
386 term
= tp
->t_termios
;
387 if ((error
= ttsetcompat(tp
, &com
, data
, &term
)) != 0) {
390 return ttioctl_locked(tp
, com
, (caddr_t
) &term
, flag
, p
);
394 * Get the current input and output speeds, and device
395 * flags, into the structure pointed to by 'data'.
398 struct sgttyb
*sg
= (struct sgttyb
*)data
;
401 sg
->sg_ospeed
= ttcompatspeedtab(tp
->t_ospeed
, compatspeeds
);
402 if (tp
->t_ispeed
== 0) {
403 sg
->sg_ispeed
= sg
->sg_ospeed
;
405 sg
->sg_ispeed
= ttcompatspeedtab(tp
->t_ispeed
, compatspeeds
);
407 sg
->sg_erase
= cc
[VERASE
];
408 sg
->sg_kill
= cc
[VKILL
];
409 sg
->sg_flags
= tp
->t_flags
= ttcompatgetflags(tp
);
414 * Get the terminal control characters into the struct
415 * tchars that 'data' points to.
418 struct tchars
*tc
= (struct tchars
*)data
;
421 tc
->t_intrc
= cc
[VINTR
];
422 tc
->t_quitc
= cc
[VQUIT
];
423 tc
->t_startc
= cc
[VSTART
];
424 tc
->t_stopc
= cc
[VSTOP
];
425 tc
->t_eofc
= cc
[VEOF
];
426 tc
->t_brkc
= cc
[VEOL
];
431 * Get the terminal control characters into the struct
432 * ltchars that 'data' points to.
435 struct ltchars
*ltc
= (struct ltchars
*)data
;
438 ltc
->t_suspc
= cc
[VSUSP
];
439 ltc
->t_dsuspc
= cc
[VDSUSP
];
440 ltc
->t_rprntc
= cc
[VREPRINT
];
441 ltc
->t_flushc
= cc
[VDISCARD
];
442 ltc
->t_werasc
= cc
[VWERASE
];
443 ltc
->t_lnextc
= cc
[VLNEXT
];
448 * Get the terminal state local flags word into the 16 bit
449 * value pointed to by 'data'.
452 (ttcompatgetflags(tp
) & 0xffff0000UL
)
453 | (tp
->t_flags
& 0xffff);
454 *(int *)data
= tp
->t_flags
>> 16;
459 * Get the current line discipline into the int pointed to
462 *(int *)data
= tp
->t_line
? tp
->t_line
: 2;
467 * Set the current line discipline based on the value of the
468 * int pointed to by 'data'.
473 return ttioctl_locked(tp
, TIOCSETD
,
474 *(int *)data
== 2 ? (caddr_t
)&ldisczero
: data
, flag
, p
);
479 * Become the console device.
482 return ttioctl_locked(tp
, TIOCCONS
, data
, flag
, p
);
486 * Get the current session ID (controlling process' PID).
488 if (tp
->t_session
== NULL
) {
492 if (tp
->t_session
->s_leader
== NULL
) {
496 *(int *) data
= tp
->t_session
->s_leader
->p_pid
;
501 * This ioctl is not handled at this layer.
507 * Successful 'get' operation.
515 * Description: Get the terminal state local flags, device flags, and current
516 * speed code for the device (all 32 bits are returned).
518 * Parameters struct tty *tp The tty on which the operation is
521 * Returns: * Integer value corresponding to the
522 * current terminal state local flags
525 * Notes: Caller is responsible for breaking these bits back out into
526 * separate 16 bit filelds, if that's what was actually desired.
529 ttcompatgetflags(struct tty
*tp
)
531 tcflag_t iflag
= tp
->t_iflag
;
532 tcflag_t lflag
= tp
->t_lflag
;
533 tcflag_t oflag
= tp
->t_oflag
;
534 tcflag_t cflag
= tp
->t_cflag
;
540 if (iflag
& ICRNL
|| oflag
& ONLCR
) {
543 if ((cflag
& CSIZE
) == CS8
) {
545 if (iflag
& ISTRIP
) {
548 } else if (cflag
& PARENB
) {
550 if (cflag
& PARODD
) {
556 flags
|= EVENP
| ODDP
;
560 if ((lflag
& ICANON
) == 0) {
562 if (iflag
& (INPCK
| ISTRIP
| IXON
) || lflag
& (IEXTEN
| ISIG
)
563 || (cflag
& (CSIZE
| PARENB
)) != CS8
) {
569 if (!(flags
& RAW
) && !(oflag
& OPOST
) && (cflag
& (CSIZE
| PARENB
)) == CS8
) {
572 if (cflag
& MDMBUF
) {
575 if ((cflag
& HUPCL
) == 0) {
578 if (oflag
& OXTABS
) {
582 flags
|= CRTERA
| CRTBS
;
584 if (lflag
& ECHOKE
) {
585 flags
|= CRTKIL
| CRTBS
;
587 if (lflag
& ECHOPRT
) {
590 if (lflag
& ECHOCTL
) {
593 if ((iflag
& IXANY
) == 0) {
596 flags
|= lflag
& (ECHO
| TOSTOP
| FLUSHO
| PENDIN
| NOFLSH
);
603 * Description: Given a set of compatability flags, convert the compatability
604 * flags in the terminal flags fields into canonical flags in the
605 * provided termios struct.
607 * Parameters: struct tty *tp The tty on which the operation is
609 * struct termios *t The termios structure into which to
610 * return the converted flags.
612 * Returns: void (implicit: *t, modified)
615 ttcompatsetflags(struct tty
*tp
, struct termios
*t
)
617 int flags
= tp
->t_flags
;
618 tcflag_t iflag
= t
->c_iflag
;
619 tcflag_t oflag
= t
->c_oflag
;
620 tcflag_t lflag
= t
->c_lflag
;
621 tcflag_t cflag
= t
->c_cflag
;
625 lflag
&= ~(ECHOCTL
| ISIG
| ICANON
| IEXTEN
);
627 iflag
&= ~(PARMRK
| IGNPAR
| IGNCR
| INLCR
);
628 iflag
|= BRKINT
| IXON
| IMAXBEL
;
629 lflag
|= ISIG
| IEXTEN
| ECHOCTL
; /* XXX was echoctl on ? */
635 if (flags
& CBREAK
) {
654 cflag
&= ~(CSIZE
| PARENB
);
655 if (flags
& (RAW
| LITOUT
| PASS8
)) {
657 if (!(flags
& (RAW
| PASS8
))
658 || (flags
& (RAW
| PASS8
| ANYP
)) == (PASS8
| ANYP
)) {
663 if (flags
& (RAW
| LITOUT
)) {
669 cflag
|= CS7
| PARENB
;
673 /* XXX don't set INPCK if RAW or PASS8? */
674 if ((flags
& (EVENP
| ODDP
)) == EVENP
) {
677 } else if ((flags
& (EVENP
| ODDP
)) == ODDP
) {
683 if (flags
& TANDEM
) {
688 if ((flags
& DECCTQ
) == 0) {
702 * Description: Given a set of compatability terminal state local flags,
703 * convert the compatability flags in the terminal flags
704 * fields into canonical flags in the provided termios struct.
706 * Parameters: struct tty *tp The tty on which the operation is
708 * struct termios *t The termios structure into which to
709 * return the converted local flags.
711 * Returns: void (implicit: *t, modified)
714 ttcompatsetlflags(struct tty
*tp
, struct termios
*t
)
716 int flags
= tp
->t_flags
;
717 tcflag_t iflag
= t
->c_iflag
;
718 tcflag_t oflag
= t
->c_oflag
;
719 tcflag_t lflag
= t
->c_lflag
;
720 tcflag_t cflag
= t
->c_cflag
;
722 iflag
&= ~(PARMRK
| IGNPAR
| IGNCR
| INLCR
);
723 if (flags
& CRTERA
) {
728 if (flags
& CRTKIL
) {
733 if (flags
& PRTERA
) {
738 if (flags
& CTLECH
) {
743 if (flags
& TANDEM
) {
748 if ((flags
& DECCTQ
) == 0) {
753 if (flags
& MDMBUF
) {
758 if (flags
& NOHANG
) {
763 lflag
&= ~(TOSTOP
| FLUSHO
| PENDIN
| NOFLSH
);
764 lflag
|= flags
& (TOSTOP
| FLUSHO
| PENDIN
| NOFLSH
);
767 * The next if-else statement is copied from above so don't bother
768 * checking it separately. We could avoid fiddlling with the
769 * character size if the mode is already RAW or if neither the
770 * LITOUT bit or the PASS8 bit is being changed, but the delta of
771 * the change is not available here and skipping the RAW case would
772 * make the code different from above.
774 cflag
&= ~(CSIZE
| PARENB
);
775 if (flags
& (RAW
| LITOUT
| PASS8
)) {
777 if (!(flags
& (RAW
| PASS8
))
778 || (flags
& (RAW
| PASS8
| ANYP
)) == (PASS8
| ANYP
)) {
783 if (flags
& (RAW
| LITOUT
)) {
789 cflag
|= CS7
| PARENB
;