annotate src/systty.h @ 111725:f861f9db770a

nnmail.el (nnmail-expiry-target-group): Protect against degenerate results from -accept-article.
author Katsumi Yamaoka <yamaoka@jpl.org>
date Fri, 26 Nov 2010 02:37:23 +0000
parents 17d793ffe36f
children 417b1e4d63cd 7df2e30d72ec
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1597
60566fdb3a25 * systty.h: Doc fix.
Jim Blandy <jimb@redhat.com>
parents: 1101
diff changeset
1 /* systty.h - System-dependent definitions for terminals.
75227
e90d04cd455a Update copyright for years from Emacs 21 to present (mainly adding
Glenn Morris <rgm@gnu.org>
parents: 68651
diff changeset
2 Copyright (C) 1993, 1994, 2001, 2002, 2003, 2004,
106815
1d1d5d9bd884 Add 2010 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 100951
diff changeset
3 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
4
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
5 This file is part of GNU Emacs.
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
6
94994
29adfc9354e7 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 91702
diff changeset
7 GNU Emacs is free software: you can redistribute it and/or modify
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
8 it under the terms of the GNU General Public License as published by
94994
29adfc9354e7 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 91702
diff changeset
9 the Free Software Foundation, either version 3 of the License, or
29adfc9354e7 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 91702
diff changeset
10 (at your option) any later version.
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
11
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
12 GNU Emacs is distributed in the hope that it will be useful,
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
15 GNU General Public License for more details.
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
16
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
17 You should have received a copy of the GNU General Public License
94994
29adfc9354e7 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 91702
diff changeset
18 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
19
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
20 /* Include the proper files. */
109949
5f187a091415 Simplify termio code.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 108908
diff changeset
21 #ifndef DOS_NT
3557
009b22e07a63 Add NO_TERMIO conditional.
Richard M. Stallman <rms@gnu.org>
parents: 3319
diff changeset
22 #ifndef NO_TERMIO
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
23 #include <termio.h>
3557
009b22e07a63 Add NO_TERMIO conditional.
Richard M. Stallman <rms@gnu.org>
parents: 3319
diff changeset
24 #endif /* not NO_TERMIO */
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
25 #include <termios.h>
1929
8ca19160362b * systty.h [HAVE_TERMIOS]: Include fcntl.h.
Jim Blandy <jimb@redhat.com>
parents: 1597
diff changeset
26 #include <fcntl.h>
9795
7993d4ffd674 Test DOS_NT, not MSDOS.
Richard M. Stallman <rms@gnu.org>
parents: 7460
diff changeset
27 #endif /* not DOS_NT */
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
28
15266
8f94c7ce22db [__GNU_LIBRARY__]: #include <sys/ioctl.h>.
Karl Heuer <kwzh@gnu.org>
parents: 14186
diff changeset
29 #include <sys/ioctl.h>
7460
dc5c72c57c70 [__GNU_LIBRARY__]: Include <termios.h>.
Roland McGrath <roland@gnu.org>
parents: 7307
diff changeset
30
108273
de8de918fbab Remove NEED_BSDTTY and NEED_UNISTD_H.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 106815
diff changeset
31 #ifdef HPUX
621
eca8812e61cd *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 578
diff changeset
32 #include <sys/bsdtty.h>
eca8812e61cd *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 578
diff changeset
33 #include <sys/ptyio.h>
eca8812e61cd *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 578
diff changeset
34 #endif
10076
a7308fb078c9 Have just one conditional to include unistd.h.
Richard M. Stallman <rms@gnu.org>
parents: 9795
diff changeset
35
621
eca8812e61cd *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 578
diff changeset
36 #ifdef AIX
eca8812e61cd *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 578
diff changeset
37 #include <sys/pty.h>
eca8812e61cd *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 578
diff changeset
38 #endif /* AIX */
eca8812e61cd *** empty log message ***
Jim Blandy <jimb@redhat.com>
parents: 578
diff changeset
39
108273
de8de918fbab Remove NEED_BSDTTY and NEED_UNISTD_H.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 106815
diff changeset
40 #ifdef HAVE_UNISTD_H
3306
6dfbd809ae8c [IRIX4]: Include unistd.h.
Richard M. Stallman <rms@gnu.org>
parents: 3269
diff changeset
41 #include <unistd.h>
6dfbd809ae8c [IRIX4]: Include unistd.h.
Richard M. Stallman <rms@gnu.org>
parents: 3269
diff changeset
42 #endif
6dfbd809ae8c [IRIX4]: Include unistd.h.
Richard M. Stallman <rms@gnu.org>
parents: 3269
diff changeset
43
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
44
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
45 /* Special cases - inhibiting the use of certain features. */
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
46
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
47 /* Allow m- file to inhibit use of FIONREAD. */
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
48 #ifdef BROKEN_FIONREAD
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
49 #undef FIONREAD
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
50 #undef ASYNC
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
51 #endif
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
52
3591
507f64624555 Apply typo patches from Paul Eggert.
Jim Blandy <jimb@redhat.com>
parents: 3557
diff changeset
53 /* Interrupt input is not used if there is no FIONREAD. */
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
54 #ifndef FIONREAD
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
55 #undef SIGIO
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
56 #endif
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
57
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
58
1101
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
59 /* Try to establish the correct character to disable terminal functions
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
60 in a system-independent manner. Note that USG (at least) define
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
61 _POSIX_VDISABLE as 0! */
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
62
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
63 #ifdef _POSIX_VDISABLE
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
64 #define CDISABLE _POSIX_VDISABLE
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
65 #else /* not _POSIX_VDISABLE */
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
66 #ifdef CDEL
3269
3e44fc755c00 * systty.h (CDISABLE): #undef it before re-#defining it.
Jim Blandy <jimb@redhat.com>
parents: 3171
diff changeset
67 #undef CDISABLE
1101
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
68 #define CDISABLE CDEL
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
69 #else /* not CDEL */
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
70 #define CDISABLE 255
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
71 #endif /* not CDEL */
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
72 #endif /* not _POSIX_VDISABLE */
3e06965680fd entered into RCS
Richard M. Stallman <rms@gnu.org>
parents: 1039
diff changeset
73
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
74 /* Get the number of characters queued for output. */
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
75
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
76 /* EMACS_OUTQSIZE(FD, int *SIZE) stores the number of characters
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
77 queued for output to the terminal FD in *SIZE, if FD is a tty.
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
78 Returns -1 if there was an error (i.e. FD is not a tty), 0
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
79 otherwise. */
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
80 #ifdef TIOCOUTQ
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
81 #define EMACS_OUTQSIZE(fd, size) (ioctl ((fd), TIOCOUTQ, (size)))
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
82 #endif
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
83
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
84
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
85 /* Manipulate a terminal's current process group. */
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
86
15562
335159567eb8 (GETPGRP_NO_ARG): Always define it, if __GNU_LIBRARY__.
Richard M. Stallman <rms@gnu.org>
parents: 15266
diff changeset
87 /* EMACS_GETPGRP (arg) returns the process group of the process. */
4959
afa76fe24878 (EMACS_GETPGRP): New macro hides argument passing to
Richard M. Stallman <rms@gnu.org>
parents: 4822
diff changeset
88
48556
646e69ae7ad6 Don't conditionally define GETPGRP_NO_ARG. Test
Dave Love <fx@gnu.org>
parents: 23990
diff changeset
89 #if defined (GETPGRP_VOID)
4959
afa76fe24878 (EMACS_GETPGRP): New macro hides argument passing to
Richard M. Stallman <rms@gnu.org>
parents: 4822
diff changeset
90 # define EMACS_GETPGRP(x) getpgrp()
97197
406ac82acbcc Fix previous change that removed BSD_TERMIOS. Add
Dan Nicolaescu <dann@ics.uci.edu>
parents: 97142
diff changeset
91 #else /* !GETPGRP_VOID */
4959
afa76fe24878 (EMACS_GETPGRP): New macro hides argument passing to
Richard M. Stallman <rms@gnu.org>
parents: 4822
diff changeset
92 # define EMACS_GETPGRP(x) getpgrp(x)
48556
646e69ae7ad6 Don't conditionally define GETPGRP_NO_ARG. Test
Dave Love <fx@gnu.org>
parents: 23990
diff changeset
93 #endif /* !GETPGRP_VOID */
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
94
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
95 /* Manipulate a TTY's input/output processing parameters. */
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
96
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
97 /* struct emacs_tty is a structure used to hold the current tty
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
98 parameters. If the terminal has several structures describing its
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
99 state, for example a struct tchars, a struct sgttyb, a struct
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
100 tchars, a struct ltchars, and a struct pagechars, struct
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
101 emacs_tty should contain an element for each parameter struct
111544
107fd4b37e9d Clean up src/systty.h macros.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 109949
diff changeset
102 that Emacs may change. */
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
103
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
104
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
105 /* For each tty parameter structure that Emacs might want to save and restore,
2873
f1cd54cf1b67 * sysdep.c (reset_sys_modes): Test the return value of
Jim Blandy <jimb@redhat.com>
parents: 2658
diff changeset
106 - include an element for it in this structure, and
f1cd54cf1b67 * sysdep.c (reset_sys_modes): Test the return value of
Jim Blandy <jimb@redhat.com>
parents: 2658
diff changeset
107 - extend the emacs_{get,set}_tty functions in sysdep.c to deal with the
f1cd54cf1b67 * sysdep.c (reset_sys_modes): Test the return value of
Jim Blandy <jimb@redhat.com>
parents: 2658
diff changeset
108 new members. */
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
109
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
110 struct emacs_tty {
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
111
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
112 /* There is always one of the following elements, so there is no need
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
113 for dummy get and set definitions. */
109949
5f187a091415 Simplify termio code.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 108908
diff changeset
114 #ifndef DOS_NT
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
115 struct termios main;
109949
5f187a091415 Simplify termio code.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 108908
diff changeset
116 #else /* DOS_NT */
5499
da0a6ed995bd [MSDOS]: don't #include <sgtty.h>. We haven't got it.
Richard M. Stallman <rms@gnu.org>
parents: 5132
diff changeset
117 int main;
109949
5f187a091415 Simplify termio code.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 108908
diff changeset
118 #endif /* DOS_NT */
2095
139f87bcbaf1 Define HAVE_TCATTR based on HAVE_TERMIOS earlier.
Richard M. Stallman <rms@gnu.org>
parents: 1929
diff changeset
119 };
139f87bcbaf1 Define HAVE_TCATTR based on HAVE_TERMIOS earlier.
Richard M. Stallman <rms@gnu.org>
parents: 1929
diff changeset
120
108908
734073f5d073 Remove INCLUDED_FCNTL.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 108273
diff changeset
121 extern int emacs_get_tty (int, struct emacs_tty *);
734073f5d073 Remove INCLUDED_FCNTL.
Dan Nicolaescu <dann@ics.uci.edu>
parents: 108273
diff changeset
122 extern int emacs_set_tty (int, struct emacs_tty *, int);
578
a4591b4d5435 Initial revision
Jim Blandy <jimb@redhat.com>
parents:
diff changeset
123