annotate src/procimpl.h @ 337:fbbf69b4e8a7 r21-0-66

Import from CVS: tag r21-0-66
author cvs
date Mon, 13 Aug 2007 10:51:02 +0200
parents e11d67e05968
children 8626e4521993
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
263
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
1 /* Processes implementation header
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
2 Copyright (C) 1985, 1992, 1993, 1994 Free Software Foundation, Inc.
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
3
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
4 This file is part of XEmacs.
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
5
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
6 XEmacs is free software; you can redistribute it and/or modify it
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
7 under the terms of the GNU General Public License as published by the
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
8 Free Software Foundation; either version 2, or (at your option) any
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
9 later version.
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
10
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
11 XEmacs is distributed in the hope that it will be useful, but WITHOUT
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
12 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
14 for more details.
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
15
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
16 You should have received a copy of the GNU General Public License
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
17 along with XEmacs; see the file COPYING. If not, write to
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
18 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
19 Boston, MA 02111-1307, USA. */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
20
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
21 /* This file must be only included by the process implementation files:
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
22 process-unix.c, process-msw.c etc. The Lisp_Process structure and other
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
23 contents of this file is not exported to the rest of the world */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
24
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
25 #ifndef _XEMACS_PROCIMPL_H_
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
26 #define _XEMACS_PROCIMPL_H_
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
27
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
28 struct Lisp_Process;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
29
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
30 /*
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
31 * Structure which keeps methods of the process implementation.
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
32 * There is only one object of this class exists in a perticular
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
33 * XEmacs implementation.
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
34 */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
35
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
36 /* #### Comment me... */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
37
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
38 struct process_methods
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
39 {
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
40 void (*mark_process_data) (struct Lisp_Process *proc,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
41 void (*markobj) (Lisp_Object));
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
42 void (*print_process_data) (struct Lisp_Process *proc,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
43 Lisp_Object printcharfun);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
44 void (*finalize_process_data) (struct Lisp_Process *proc, int for_disksave);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
45 void (*alloc_process_data) (struct Lisp_Process *p);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
46 void (*init_process_io_handles) (struct Lisp_Process *p,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
47 void* in, void* out, int flags);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
48 int (*create_process) (struct Lisp_Process *p,
288
e11d67e05968 Import from CVS: tag r21-0b42
cvs
parents: 278
diff changeset
49 Lisp_Object *argv, int nargv,
e11d67e05968 Import from CVS: tag r21-0b42
cvs
parents: 278
diff changeset
50 Lisp_Object program, Lisp_Object cur_dir);
263
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
51 int (*tooltalk_connection_p) (struct Lisp_Process *p);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
52 #ifdef HAVE_SOCKETS
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
53 void (*open_network_stream) (Lisp_Object name, Lisp_Object host,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
54 Lisp_Object service, Lisp_Object family,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
55 void** vinfd, void** voutfd);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
56 #ifdef HAVE_MULTICAST
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
57 void (*open_multicast_group) (Lisp_Object name, Lisp_Object dest,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
58 Lisp_Object port, Lisp_Object ttl,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
59 void** vinfd, void** voutfd);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
60 #endif /* HAVE_MULTICAST */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
61 #endif /* HAVE_SOCKETS */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
62 Lisp_Object (*canonicalize_host_name) (Lisp_Object host);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
63 int (*set_window_size) (struct Lisp_Process* p, int height, int width);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
64 void (*send_process) (Lisp_Object proc, struct lstream* lstream);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
65 void (*reap_exited_processes) (void);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
66 void (*update_status_if_terminated) (struct Lisp_Process* p);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
67 void (*kill_child_process) (Lisp_Object proc, int signo,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
68 int current_group, int nomsg);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
69 int (*kill_process_by_pid) (int pid, int sigcode);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
70 int (*process_send_eof) (Lisp_Object proc);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
71 Lisp_Object (*get_tty_name) (struct Lisp_Process *p);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
72 USID (*deactivate_process) (struct Lisp_Process *p);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
73 void (*init_process) (void);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
74 };
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
75
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
76 extern struct process_methods the_process_methods;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
77
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
78 /*
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
79 * Accessors for process_methods
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
80 */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
81
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
82 #define HAS_PROCMETH_P(name) (the_process_methods.name != 0)
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
83 #define PROCMETH(name, par) ((the_process_methods.name) par)
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
84 #define PROCMETH_OR_GIVEN(name, par, given) (HAS_PROCMETH_P(name) ? PROCMETH(name, par) : (given))
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
85 #define MAYBE_PROCMETH(name, par) do { if (HAS_PROCMETH_P(name)) PROCMETH(name, par); } while (0);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
86 #define MAYBE_LISP_PROCMETH(name, par) PROCMETH_OR_GIVEN(name, par, Qnil)
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
87 #define MAYBE_INT_PROCMETH(name, par) PROCMETH_OR_GIVEN(name, par, 0)
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
88 #define PROCESS_HAS_METHOD(os, name) the_process_methods.name = os##_##name
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
89
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
90 /*
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
91 * Structure records pertinent information about open channels.
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
92 * There is one channel associated with each process.
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
93 */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
94
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
95 struct Lisp_Process
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
96 {
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
97 struct lcrecord_header header;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
98 /* Name of this process */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
99 Lisp_Object name;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
100 /* List of command arguments that this process was run with */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
101 Lisp_Object command;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
102 /* (funcall FILTER PROC STRING) (if FILTER is non-nil)
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
103 to dispose of a bunch of chars from the process all at once */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
104 Lisp_Object filter;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
105 /* (funcall SENTINEL PROCESS) when process state changes */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
106 Lisp_Object sentinel;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
107 /* Buffer that output is going to */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
108 Lisp_Object buffer;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
109 /* Marker set to end of last buffer-inserted output from this process */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
110 Lisp_Object mark;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
111 /* Lisp_Int of subprocess' PID, or a cons of
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
112 service/host if this is really a network connection */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
113 Lisp_Object pid;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
114
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
115 /* Symbol indicating status of process.
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
116 This may be a symbol: run, stop, exit, signal */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
117 Lisp_Object status_symbol;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
118
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
119 /* Exit code if process has terminated,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
120 signal which stopped/interrupted process
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
121 or 0 if process is running */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
122 int exit_code;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
123 /* Non-false if process has exited and "dumped core" on its way down */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
124 char core_dumped;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
125
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
126 /* This next field is only actually used #ifdef ENERGIZE */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
127 /* if this flag is not NIL, then filter will do the read on the
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
128 channel, rather than having a call to make_string.
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
129 This only works if the filter is a subr. */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
130 char filter_does_read;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
131 /* Non-nil means kill silently if Emacs is exited. */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
132 char kill_without_query;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
133 char selected;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
134 /* Event-count of last event in which this process changed status. */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
135 volatile int tick;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
136 /* Event-count of last such event reported. */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
137 int update_tick;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
138 /* Low level streams used in input and output, connected to child */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
139 Lisp_Object pipe_instream;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
140 Lisp_Object pipe_outstream;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
141 #ifdef FILE_CODING
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
142 /* Data end streams, decoding and encoding pipe_* streams */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
143 Lisp_Object coding_instream;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
144 Lisp_Object coding_outstream;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
145 #endif
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
146
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
147 /* Implementation dependent data */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
148 void *process_data;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
149 };
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
150
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
151 /* Macros to refer to data connection streams */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
152 #ifdef FILE_CODING
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
153 #define DATA_INSTREAM(p) (p)->coding_instream
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
154 #define DATA_OUTSTREAM(p) (p)->coding_outstream
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
155 #else
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
156 #define DATA_INSTREAM(p) (p)->pipe_instream
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
157 #define DATA_OUTSTREAM(p) (p)->pipe_outstream
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
158 #endif
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
159
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
160 /* Random externs from process.c */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
161 extern Lisp_Object Qrun, Qstop, Qopen, Qclosed;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
162 extern Lisp_Object Qtcpip;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
163 extern Lisp_Object Vprocess_connection_type;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
164 extern Lisp_Object Vprocess_list;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
165
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
166 extern c_hashtable usid_to_process;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
167
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
168 extern volatile int process_tick;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
169
278
90d73dddcdc4 Import from CVS: tag r21-0b37
cvs
parents: 263
diff changeset
170 extern int windowed_process_io;
90d73dddcdc4 Import from CVS: tag r21-0b37
cvs
parents: 263
diff changeset
171
263
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
172 #ifdef HAVE_MULTICAST
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
173 extern Lisp_Object Qmulticast;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
174 #endif
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
175
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
176 #ifdef PROCESS_IO_BLOCKING
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
177 extern Lisp_Object network_stream_blocking_port_list;
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
178 #endif /* PROCESS_IO_BLOCKING */
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
179
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
180 Lisp_Object make_process_internal (Lisp_Object name);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
181 void init_process_io_handles (struct Lisp_Process *p, void* in,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
182 void* out, int flags);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
183 void send_process (Lisp_Object proc,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
184 Lisp_Object relocatable,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
185 CONST Bufbyte *nonrelocatable,
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
186 int start, int len);
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
187
727739f917cb Import from CVS: tag r20-5b30
cvs
parents:
diff changeset
188 #endif /* _XEMACS_PROCIMPL_H_ */