Mercurial > emacs
annotate src/process.h @ 60529:4358de407410
(mark-diary-entries): Only call redraw-calendar in the first of any
recursive calls. Reported by Alan Shutko <ats@acm.org>.
author | Glenn Morris <rgm@gnu.org> |
---|---|
date | Wed, 09 Mar 2005 00:29:14 +0000 |
parents | f37373c2902a |
children | 20c2d120fc79 |
rev | line source |
---|---|
365 | 1 /* Definitions for asynchronous process control in GNU Emacs. |
7307 | 2 Copyright (C) 1985, 1994 Free Software Foundation, Inc. |
365 | 3 |
4 This file is part of GNU Emacs. | |
5 | |
6 GNU Emacs is free software; you can redistribute it and/or modify | |
7 it under the terms of the GNU General Public License as published by | |
12244 | 8 the Free Software Foundation; either version 2, or (at your option) |
365 | 9 any later version. |
10 | |
11 GNU Emacs is distributed in the hope that it will be useful, | |
12 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
14 GNU General Public License for more details. | |
15 | |
16 You should have received a copy of the GNU General Public License | |
17 along with GNU Emacs; see the file COPYING. If not, write to | |
14186
ee40177f6c68
Update FSF's address in the preamble.
Erik Naggum <erik@naggum.no>
parents:
14036
diff
changeset
|
18 the Free Software Foundation, Inc., 59 Temple Place - Suite 330, |
ee40177f6c68
Update FSF's address in the preamble.
Erik Naggum <erik@naggum.no>
parents:
14036
diff
changeset
|
19 Boston, MA 02111-1307, USA. */ |
365 | 20 |
21 | |
21849
96fd475a324d
(struct process): Make inherit_coding_system_flag a Lisp_Object.
Richard M. Stallman <rms@gnu.org>
parents:
21657
diff
changeset
|
22 /* This structure records information about a subprocess |
96fd475a324d
(struct process): Make inherit_coding_system_flag a Lisp_Object.
Richard M. Stallman <rms@gnu.org>
parents:
21657
diff
changeset
|
23 or network connection. |
96fd475a324d
(struct process): Make inherit_coding_system_flag a Lisp_Object.
Richard M. Stallman <rms@gnu.org>
parents:
21657
diff
changeset
|
24 |
96fd475a324d
(struct process): Make inherit_coding_system_flag a Lisp_Object.
Richard M. Stallman <rms@gnu.org>
parents:
21657
diff
changeset
|
25 Every field in this structure except for the first two |
96fd475a324d
(struct process): Make inherit_coding_system_flag a Lisp_Object.
Richard M. Stallman <rms@gnu.org>
parents:
21657
diff
changeset
|
26 must be a Lisp_Object, for GC's sake. */ |
365 | 27 |
28 struct Lisp_Process | |
29 { | |
10286
5689759b9329
Make size field an EMACS_INT.
Richard M. Stallman <rms@gnu.org>
parents:
8888
diff
changeset
|
30 EMACS_INT size; |
365 | 31 struct Lisp_Vector *v_next; |
32 /* Descriptor by which we read from this process */ | |
33 Lisp_Object infd; | |
34 /* Descriptor by which we write to this process */ | |
35 Lisp_Object outfd; | |
8888
84527c2d9f75
(struct process): New field tty_name.
Richard M. Stallman <rms@gnu.org>
parents:
7307
diff
changeset
|
36 /* Name of subprocess terminal. */ |
84527c2d9f75
(struct process): New field tty_name.
Richard M. Stallman <rms@gnu.org>
parents:
7307
diff
changeset
|
37 Lisp_Object tty_name; |
365 | 38 /* Name of this process */ |
39 Lisp_Object name; | |
43967
7e0389460d9d
(struct Lisp_Process): New member log.
Kim F. Storm <storm@cua.dk>
parents:
39935
diff
changeset
|
40 /* List of command arguments that this process was run with. |
7e0389460d9d
(struct Lisp_Process): New member log.
Kim F. Storm <storm@cua.dk>
parents:
39935
diff
changeset
|
41 Is set to t for a stopped network process; nil otherwise. */ |
365 | 42 Lisp_Object command; |
43 /* (funcall FILTER PROC STRING) (if FILTER is non-nil) | |
44 to dispose of a bunch of chars from the process all at once */ | |
45 Lisp_Object filter; | |
46 /* (funcall SENTINEL PROCESS) when process state changes */ | |
47 Lisp_Object sentinel; | |
43967
7e0389460d9d
(struct Lisp_Process): New member log.
Kim F. Storm <storm@cua.dk>
parents:
39935
diff
changeset
|
48 /* (funcall LOG SERVER CLIENT MESSAGE) when a server process |
7e0389460d9d
(struct Lisp_Process): New member log.
Kim F. Storm <storm@cua.dk>
parents:
39935
diff
changeset
|
49 accepts a connection from a client. */ |
7e0389460d9d
(struct Lisp_Process): New member log.
Kim F. Storm <storm@cua.dk>
parents:
39935
diff
changeset
|
50 Lisp_Object log; |
365 | 51 /* Buffer that output is going to */ |
52 Lisp_Object buffer; | |
53 /* Number of this process */ | |
54 Lisp_Object pid; | |
55 /* Non-nil if this is really a command channel */ | |
56 Lisp_Object command_channel_p; | |
16059 | 57 /* t if this is a real child process. |
43967
7e0389460d9d
(struct Lisp_Process): New member log.
Kim F. Storm <storm@cua.dk>
parents:
39935
diff
changeset
|
58 For a net connection, it is a plist based on the arguments to make-network-process. */ |
365 | 59 Lisp_Object childp; |
49222
bfa7cad7b524
(struct Lisp_Process): New member plist replaces old
Kim F. Storm <storm@cua.dk>
parents:
49163
diff
changeset
|
60 /* Plist for programs to keep per-process state information, parameters, etc. */ |
bfa7cad7b524
(struct Lisp_Process): New member plist replaces old
Kim F. Storm <storm@cua.dk>
parents:
49163
diff
changeset
|
61 Lisp_Object plist; |
365 | 62 /* Marker set to end of last buffer-inserted output from this process */ |
63 Lisp_Object mark; | |
43967
7e0389460d9d
(struct Lisp_Process): New member log.
Kim F. Storm <storm@cua.dk>
parents:
39935
diff
changeset
|
64 /* Non-nil means kill silently if Emacs is exited. |
7e0389460d9d
(struct Lisp_Process): New member log.
Kim F. Storm <storm@cua.dk>
parents:
39935
diff
changeset
|
65 This is the inverse of the `query-on-exit' flag. */ |
365 | 66 Lisp_Object kill_without_query; |
67 /* Record the process status in the raw form in which it comes from `wait'. | |
68 This is to avoid consing in a signal handler. */ | |
69 Lisp_Object raw_status_low; | |
70 Lisp_Object raw_status_high; | |
71 /* Symbol indicating status of process. | |
72 This may be a symbol: run, open, or closed. | |
73 Or it may be a list, whose car is stop, exit or signal | |
74 and whose cdr is a pair (EXIT_CODE . COREDUMP_FLAG) | |
75 or (SIGNAL_NUMBER . COREDUMP_FLAG). */ | |
76 Lisp_Object status; | |
77 /* Non-nil if communicating through a pty. */ | |
78 Lisp_Object pty_flag; | |
79 /* Event-count of last event in which this process changed status. */ | |
80 Lisp_Object tick; | |
81 /* Event-count of last such event reported. */ | |
82 Lisp_Object update_tick; | |
17042
00b923d54108
(struct Lisp_Process): New members
Karl Heuer <kwzh@gnu.org>
parents:
16059
diff
changeset
|
83 /* Coding-system for decoding the input from this process. */ |
00b923d54108
(struct Lisp_Process): New members
Karl Heuer <kwzh@gnu.org>
parents:
16059
diff
changeset
|
84 Lisp_Object decode_coding_system; |
00b923d54108
(struct Lisp_Process): New members
Karl Heuer <kwzh@gnu.org>
parents:
16059
diff
changeset
|
85 /* Working buffer for decoding. */ |
00b923d54108
(struct Lisp_Process): New members
Karl Heuer <kwzh@gnu.org>
parents:
16059
diff
changeset
|
86 Lisp_Object decoding_buf; |
20714
ead6c5a556e1
(struct Lisp_Process): New members decoding_carryover
Kenichi Handa <handa@m17n.org>
parents:
17042
diff
changeset
|
87 /* Size of carryover in decoding. */ |
ead6c5a556e1
(struct Lisp_Process): New members decoding_carryover
Kenichi Handa <handa@m17n.org>
parents:
17042
diff
changeset
|
88 Lisp_Object decoding_carryover; |
17042
00b923d54108
(struct Lisp_Process): New members
Karl Heuer <kwzh@gnu.org>
parents:
16059
diff
changeset
|
89 /* Coding-system for encoding the output to this process. */ |
00b923d54108
(struct Lisp_Process): New members
Karl Heuer <kwzh@gnu.org>
parents:
16059
diff
changeset
|
90 Lisp_Object encode_coding_system; |
00b923d54108
(struct Lisp_Process): New members
Karl Heuer <kwzh@gnu.org>
parents:
16059
diff
changeset
|
91 /* Working buffer for encoding. */ |
00b923d54108
(struct Lisp_Process): New members
Karl Heuer <kwzh@gnu.org>
parents:
16059
diff
changeset
|
92 Lisp_Object encoding_buf; |
20714
ead6c5a556e1
(struct Lisp_Process): New members decoding_carryover
Kenichi Handa <handa@m17n.org>
parents:
17042
diff
changeset
|
93 /* Size of carryover in encoding. */ |
ead6c5a556e1
(struct Lisp_Process): New members decoding_carryover
Kenichi Handa <handa@m17n.org>
parents:
17042
diff
changeset
|
94 Lisp_Object encoding_carryover; |
21657
373f809e0b95
(struct Lisp_Process): Add inherit_coding_system_flag member.
Eli Zaretskii <eliz@gnu.org>
parents:
20714
diff
changeset
|
95 /* Flag to set coding-system of the process buffer from the |
373f809e0b95
(struct Lisp_Process): Add inherit_coding_system_flag member.
Eli Zaretskii <eliz@gnu.org>
parents:
20714
diff
changeset
|
96 coding_system used to decode process output. */ |
21849
96fd475a324d
(struct process): Make inherit_coding_system_flag a Lisp_Object.
Richard M. Stallman <rms@gnu.org>
parents:
21657
diff
changeset
|
97 Lisp_Object inherit_coding_system_flag; |
49666
9f435c19ea6f
(struct Lisp_Process): New member filter_multibyte.
Kenichi Handa <handa@m17n.org>
parents:
49222
diff
changeset
|
98 /* Flat to decide the multibyteness of a string given to the |
9f435c19ea6f
(struct Lisp_Process): New member filter_multibyte.
Kenichi Handa <handa@m17n.org>
parents:
49222
diff
changeset
|
99 filter (if any). It is initialized to the value of |
9f435c19ea6f
(struct Lisp_Process): New member filter_multibyte.
Kenichi Handa <handa@m17n.org>
parents:
49222
diff
changeset
|
100 `default-enable-multibyte-characters' when the process is |
9f435c19ea6f
(struct Lisp_Process): New member filter_multibyte.
Kenichi Handa <handa@m17n.org>
parents:
49222
diff
changeset
|
101 generated, and can be changed by the function |
9f435c19ea6f
(struct Lisp_Process): New member filter_multibyte.
Kenichi Handa <handa@m17n.org>
parents:
49222
diff
changeset
|
102 `set-process-fileter-multibyte'. */ |
9f435c19ea6f
(struct Lisp_Process): New member filter_multibyte.
Kenichi Handa <handa@m17n.org>
parents:
49222
diff
changeset
|
103 Lisp_Object filter_multibyte; |
53471
b3ac4cfe9253
(struct Lisp_Process): New members for adaptive read
Kim F. Storm <storm@cua.dk>
parents:
52401
diff
changeset
|
104 /* Should we delay reading output from this process. |
b3ac4cfe9253
(struct Lisp_Process): New members for adaptive read
Kim F. Storm <storm@cua.dk>
parents:
52401
diff
changeset
|
105 Initialized from `Vprocess_adaptive_read_buffering'. */ |
b3ac4cfe9253
(struct Lisp_Process): New members for adaptive read
Kim F. Storm <storm@cua.dk>
parents:
52401
diff
changeset
|
106 Lisp_Object adaptive_read_buffering; |
b3ac4cfe9253
(struct Lisp_Process): New members for adaptive read
Kim F. Storm <storm@cua.dk>
parents:
52401
diff
changeset
|
107 /* Hysteresis to try to read process output in larger blocks. |
b3ac4cfe9253
(struct Lisp_Process): New members for adaptive read
Kim F. Storm <storm@cua.dk>
parents:
52401
diff
changeset
|
108 On some systems, e.g. the Linux kernel, emacs is seen as |
b3ac4cfe9253
(struct Lisp_Process): New members for adaptive read
Kim F. Storm <storm@cua.dk>
parents:
52401
diff
changeset
|
109 an interactive app also when reading process output, meaning |
b3ac4cfe9253
(struct Lisp_Process): New members for adaptive read
Kim F. Storm <storm@cua.dk>
parents:
52401
diff
changeset
|
110 that process output can be read in as little as 1 byte at a |
b3ac4cfe9253
(struct Lisp_Process): New members for adaptive read
Kim F. Storm <storm@cua.dk>
parents:
52401
diff
changeset
|
111 time. Value is micro-seconds to delay reading output from |
b3ac4cfe9253
(struct Lisp_Process): New members for adaptive read
Kim F. Storm <storm@cua.dk>
parents:
52401
diff
changeset
|
112 this process. Range is 0 .. 50000. */ |
b3ac4cfe9253
(struct Lisp_Process): New members for adaptive read
Kim F. Storm <storm@cua.dk>
parents:
52401
diff
changeset
|
113 Lisp_Object read_output_delay; |
b3ac4cfe9253
(struct Lisp_Process): New members for adaptive read
Kim F. Storm <storm@cua.dk>
parents:
52401
diff
changeset
|
114 /* Skip reading this process on next read. */ |
b3ac4cfe9253
(struct Lisp_Process): New members for adaptive read
Kim F. Storm <storm@cua.dk>
parents:
52401
diff
changeset
|
115 Lisp_Object read_output_skip; |
365 | 116 }; |
117 | |
21849
96fd475a324d
(struct process): Make inherit_coding_system_flag a Lisp_Object.
Richard M. Stallman <rms@gnu.org>
parents:
21657
diff
changeset
|
118 /* Every field in the preceding structure except for the first two |
96fd475a324d
(struct process): Make inherit_coding_system_flag a Lisp_Object.
Richard M. Stallman <rms@gnu.org>
parents:
21657
diff
changeset
|
119 must be a Lisp_Object, for GC's sake. */ |
96fd475a324d
(struct process): Make inherit_coding_system_flag a Lisp_Object.
Richard M. Stallman <rms@gnu.org>
parents:
21657
diff
changeset
|
120 |
365 | 121 #define ChannelMask(n) (1<<(n)) |
122 | |
6165
9c0cc4128da8
(chan_process, Vprocess_alist): Declared.
Richard M. Stallman <rms@gnu.org>
parents:
2432
diff
changeset
|
123 /* Indexed by descriptor, gives the process (if any) for that descriptor. */ |
6191
84fc456177e2
(chan_process): Don't specify size.
Karl Heuer <kwzh@gnu.org>
parents:
6165
diff
changeset
|
124 extern Lisp_Object chan_process[]; |
6165
9c0cc4128da8
(chan_process, Vprocess_alist): Declared.
Richard M. Stallman <rms@gnu.org>
parents:
2432
diff
changeset
|
125 |
9c0cc4128da8
(chan_process, Vprocess_alist): Declared.
Richard M. Stallman <rms@gnu.org>
parents:
2432
diff
changeset
|
126 /* Alist of elements (NAME . PROCESS). */ |
9c0cc4128da8
(chan_process, Vprocess_alist): Declared.
Richard M. Stallman <rms@gnu.org>
parents:
2432
diff
changeset
|
127 extern Lisp_Object Vprocess_alist; |
9c0cc4128da8
(chan_process, Vprocess_alist): Declared.
Richard M. Stallman <rms@gnu.org>
parents:
2432
diff
changeset
|
128 |
365 | 129 /* True iff we are about to fork off a synchronous process or if we |
130 are waiting for it. */ | |
131 extern int synch_process_alive; | |
132 | |
14036 | 133 /* Communicate exit status of sync process to from sigchld_handler |
546 | 134 to Fcall_process. */ |
135 | |
365 | 136 /* Nonzero => this is a string explaining death of synchronous subprocess. */ |
137 extern char *synch_process_death; | |
138 | |
53714
77ad9650fc55
synch_process_termsig new variable.
Jan Djärv <jan.h.d@swipnet.se>
parents:
53471
diff
changeset
|
139 /* Nonzero => this is the signal number that terminated the subprocess. */ |
53726
f37373c2902a
* process.h: Add extern to synch_process_termsig.
Jan Djärv <jan.h.d@swipnet.se>
parents:
53714
diff
changeset
|
140 extern int synch_process_termsig; |
53714
77ad9650fc55
synch_process_termsig new variable.
Jan Djärv <jan.h.d@swipnet.se>
parents:
53471
diff
changeset
|
141 |
365 | 142 /* If synch_process_death is zero, |
143 this is exit code of synchronous subprocess. */ | |
144 extern int synch_process_retcode; | |
145 | |
2432
17a84e60603b
New macros NULL_DEVICE and EXEC_SUFFIXES, to give the name of the
Jim Blandy <jimb@redhat.com>
parents:
546
diff
changeset
|
146 /* The name of the file open to get a null file, or a data sink. |
17a84e60603b
New macros NULL_DEVICE and EXEC_SUFFIXES, to give the name of the
Jim Blandy <jimb@redhat.com>
parents:
546
diff
changeset
|
147 VMS, MS-DOS, and OS/2 redefine this. */ |
17a84e60603b
New macros NULL_DEVICE and EXEC_SUFFIXES, to give the name of the
Jim Blandy <jimb@redhat.com>
parents:
546
diff
changeset
|
148 #ifndef NULL_DEVICE |
17a84e60603b
New macros NULL_DEVICE and EXEC_SUFFIXES, to give the name of the
Jim Blandy <jimb@redhat.com>
parents:
546
diff
changeset
|
149 #define NULL_DEVICE "/dev/null" |
17a84e60603b
New macros NULL_DEVICE and EXEC_SUFFIXES, to give the name of the
Jim Blandy <jimb@redhat.com>
parents:
546
diff
changeset
|
150 #endif |
52401 | 151 |
152 /* arch-tag: dffedfc4-d7bc-4b58-a26f-c16155449c72 | |
153 (do not change this comment) */ |