Mercurial > hg > xemacs-beta
annotate src/procimpl.h @ 5142:f965e31a35f0
reduce lcrecord headers to 2 words, rename printing_unreadable_object
-------------------- ChangeLog entries follow: --------------------
man/ChangeLog addition:
2010-03-13 Ben Wing <ben@xemacs.org>
* internals/internals.texi (Working with Lisp Objects):
* internals/internals.texi (Writing Macros):
* internals/internals.texi (lrecords):
More rewriting to correspond with changes from
*LRECORD* to *LISP_OBJECT*.
modules/ChangeLog addition:
2010-03-13 Ben Wing <ben@xemacs.org>
* postgresql/postgresql.c (print_pgconn):
* postgresql/postgresql.c (print_pgresult):
printing_unreadable_object -> printing_unreadable_object_fmt.
2010-03-13 Ben Wing <ben@xemacs.org>
* ldap/eldap.c (print_ldap):
printing_unreadable_object -> printing_unreadable_object_fmt.
src/ChangeLog addition:
2010-03-13 Ben Wing <ben@xemacs.org>
* alloc.c (alloc_sized_lrecord_1):
* alloc.c (alloc_sized_lrecord_array):
* alloc.c (old_alloc_sized_lcrecord):
* alloc.c (disksave_object_finalization_1):
* alloc.c (mark_lcrecord_list):
* alloc.c (alloc_managed_lcrecord):
* alloc.c (free_managed_lcrecord):
* alloc.c (tick_lcrecord_stats):
* alloc.c (sweep_lcrecords_1):
* buffer.c (print_buffer):
* buffer.c (DEFVAR_BUFFER_LOCAL_1):
* casetab.c:
* casetab.c (print_case_table):
* console.c (print_console):
* console.c (DEFVAR_CONSOLE_LOCAL_1):
* data.c (print_weak_list):
* data.c (print_weak_box):
* data.c (print_ephemeron):
* data.c (ephemeron_equal):
* database.c (print_database):
* database.c (finalize_database):
* device-msw.c (sync_printer_with_devmode):
* device-msw.c (print_devmode):
* device-msw.c (finalize_devmode):
* device.c:
* device.c (print_device):
* elhash.c:
* elhash.c (print_hash_table):
* eval.c (print_subr):
* eval.c (print_multiple_value):
* event-stream.c (event_stream_resignal_wakeup):
* events.c (clear_event_resource):
* events.c (zero_event):
* events.c (print_event):
* extents.c:
* extents.c (print_extent):
* file-coding.c (print_coding_system):
* font-mgr.c:
* font-mgr.c (Ffc_init):
* frame.c:
* frame.c (print_frame):
* gc.c:
* gc.c (GC_CHECK_NOT_FREE):
* glyphs.c:
* glyphs.c (print_image_instance):
* glyphs.c (print_glyph):
* gui.c (print_gui_item):
* gui.c (copy_gui_item):
* keymap.c (print_keymap):
* keymap.c (MARKED_SLOT):
* lisp.h:
* lisp.h (struct Lisp_String):
* lisp.h (DEFUN):
* lisp.h (DEFUN_NORETURN):
* lrecord.h:
* lrecord.h (NORMAL_LISP_OBJECT_UID):
* lrecord.h (struct lrecord_header):
* lrecord.h (set_lheader_implementation):
* lrecord.h (struct old_lcrecord_header):
* lrecord.h (struct free_lcrecord_header):
* marker.c (print_marker):
* mule-charset.c:
* mule-charset.c (print_charset):
* objects.c (print_color_instance):
* objects.c (print_font_instance):
* objects.c (finalize_font_instance):
* print.c (print_cons):
* print.c (printing_unreadable_object_fmt):
* print.c (printing_unreadable_lisp_object):
* print.c (external_object_printer):
* print.c (internal_object_printer):
* print.c (debug_p4):
* print.c (ext_print_begin):
* process.c (print_process):
* rangetab.c (print_range_table):
* rangetab.c (range_table_equal):
* scrollbar.c (free_scrollbar_instance):
* specifier.c (print_specifier):
* specifier.c (finalize_specifier):
* symbols.c (guts_of_unbound_marker):
* symeval.h:
* symeval.h (DEFVAR_SYMVAL_FWD):
* tooltalk.c:
* tooltalk.c (print_tooltalk_message):
* tooltalk.c (print_tooltalk_pattern):
* ui-gtk.c (ffi_object_printer):
* ui-gtk.c (emacs_gtk_object_printer):
* ui-gtk.c (emacs_gtk_boxed_printer):
* window.c (print_window):
* window.c (free_window_mirror):
* window.c (debug_print_window):
* xemacs.def.in.in:
(1) printing_unreadable_object -> printing_unreadable_object_fmt.
(2) printing_unreadable_lcrecord -> printing_unreadable_lisp_object
and fix up so it no longer requires an lcrecord.
These previous changes eliminate most of the remaining places where
the terms `lcrecord' and `lrecord' occurred outside of specialized
code.
(3) Fairly major change: Reduce the number of words in an lcrecord
from 3 to 2. The third word consisted of a uid that duplicated the
lrecord uid, and a single free bit, which was moved into the lrecord
structure. This reduces the size of the `uid' slot from 21 bits to
20 bits. Arguably this isn't enough -- we could easily have more than
1,000,000 or so objects created in a session. The answer is
(a) It doesn't really matter if we overflow the uid field because
it's only used for debugging, to identify an object uniquely
(or pretty much so).
(b) If we cared about it overflowing and wanted to reduce this,
we could make it so that cons, string, float and certain other
frob-block types that never print out the uid simply don't
store a uid in them and don't increment the lrecord_uid_counter.
(4) In conjunction with (3), create new macro NORMAL_LISP_OBJECT_UID()
and use it to abstract out the differences between NEWGC and old-GC
in accessing the `uid' value from a "normal Lisp Object pointer".
(5) In events.c, use zero_nonsized_lisp_object() in place of custom-
written equivalent. In font-mgr.c use external_object_printer()
in place of custom-written equivalents.
| author | Ben Wing <ben@xemacs.org> |
|---|---|
| date | Sat, 13 Mar 2010 05:38:08 -0600 |
| parents | a9c41067dd88 |
| children | 308d34e9f07d |
| rev | line source |
|---|---|
| 428 | 1 /* Processes implementation header |
| 2 Copyright (C) 1985, 1992, 1993, 1994 Free Software Foundation, Inc. | |
| 853 | 3 Copyright (C) 2002 Ben Wing. |
| 428 | 4 |
| 5 This file is part of XEmacs. | |
| 6 | |
| 7 XEmacs is free software; you can redistribute it and/or modify it | |
| 8 under the terms of the GNU General Public License as published by the | |
| 9 Free Software Foundation; either version 2, or (at your option) any | |
| 10 later version. | |
| 11 | |
| 12 XEmacs is distributed in the hope that it will be useful, but WITHOUT | |
| 13 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
| 14 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
| 15 for more details. | |
| 16 | |
| 17 You should have received a copy of the GNU General Public License | |
| 18 along with XEmacs; see the file COPYING. If not, write to | |
| 19 the Free Software Foundation, Inc., 59 Temple Place - Suite 330, | |
| 20 Boston, MA 02111-1307, USA. */ | |
| 21 | |
| 1204 | 22 /* Synched up with: ????. Split out of process.h. */ |
| 23 | |
| 428 | 24 /* This file must be only included by the process implementation files: |
| 25 process-unix.c, process-msw.c etc. The Lisp_Process structure and other | |
| 26 contents of this file is not exported to the rest of the world */ | |
| 27 | |
| 440 | 28 #ifndef INCLUDED_procimpl_h_ |
| 29 #define INCLUDED_procimpl_h_ | |
| 428 | 30 |
| 31 /* | |
| 32 * Structure which keeps methods of the process implementation. | |
| 33 * There is only one object of this class exists in a particular | |
| 34 * XEmacs implementation. | |
| 35 */ | |
| 36 | |
| 37 /* #### Comment me... */ | |
| 38 | |
| 39 struct process_methods | |
| 40 { | |
| 440 | 41 void (*print_process_data) (Lisp_Process *proc, Lisp_Object printcharfun); |
|
5124
623d57b7fbe8
separate regular and disksave finalization, print method fixes.
Ben Wing <ben@xemacs.org>
parents:
5120
diff
changeset
|
42 void (*finalize_process_data) (Lisp_Process *proc); |
| 440 | 43 void (*alloc_process_data) (Lisp_Process *p); |
| 44 void (*init_process_io_handles) (Lisp_Process *p, | |
| 853 | 45 void* in, void* out, void *err, int flags); |
| 440 | 46 int (*create_process) (Lisp_Process *p, |
| 428 | 47 Lisp_Object *argv, int nargv, |
| 853 | 48 Lisp_Object program, Lisp_Object cur_dir, |
| 49 int separate_err); | |
| 440 | 50 int (*tooltalk_connection_p) (Lisp_Process *p); |
| 428 | 51 #ifdef HAVE_SOCKETS |
| 52 void (*open_network_stream) (Lisp_Object name, Lisp_Object host, | |
| 53 Lisp_Object service, Lisp_Object protocol, | |
| 54 void** vinfd, void** voutfd); | |
| 55 #ifdef HAVE_MULTICAST | |
| 56 void (*open_multicast_group) (Lisp_Object name, Lisp_Object dest, | |
| 57 Lisp_Object port, Lisp_Object ttl, | |
| 58 void** vinfd, void** voutfd); | |
| 59 #endif /* HAVE_MULTICAST */ | |
| 60 #endif /* HAVE_SOCKETS */ | |
| 61 Lisp_Object (*canonicalize_host_name) (Lisp_Object host); | |
| 440 | 62 int (*set_window_size) (Lisp_Process* p, int height, int width); |
| 428 | 63 void (*send_process) (Lisp_Object proc, struct lstream* lstream); |
| 64 void (*reap_exited_processes) (void); | |
| 440 | 65 void (*update_status_if_terminated) (Lisp_Process* p); |
| 428 | 66 void (*kill_child_process) (Lisp_Object proc, int signo, |
| 67 int current_group, int nomsg); | |
| 68 int (*kill_process_by_pid) (int pid, int sigcode); | |
| 69 int (*process_send_eof) (Lisp_Object proc); | |
| 853 | 70 void (*deactivate_process) (Lisp_Process *p, |
| 71 USID* in_usid, | |
| 72 USID* err_usid); | |
| 428 | 73 void (*init_process) (void); |
| 74 }; | |
| 75 | |
| 76 extern struct process_methods the_process_methods; | |
| 77 | |
| 78 /* | |
| 79 * Accessors for process_methods | |
| 80 */ | |
| 81 | |
| 82 #define HAS_PROCMETH_P(name) (the_process_methods.name != 0) | |
| 83 #define PROCMETH(name, par) ((the_process_methods.name) par) | |
| 84 #define PROCMETH_OR_GIVEN(name, par, given) (HAS_PROCMETH_P(name) ? PROCMETH(name, par) : (given)) | |
| 85 #define MAYBE_PROCMETH(name, par) do { if (HAS_PROCMETH_P(name)) PROCMETH(name, par); } while (0); | |
| 86 #define MAYBE_LISP_PROCMETH(name, par) PROCMETH_OR_GIVEN(name, par, Qnil) | |
| 87 #define MAYBE_INT_PROCMETH(name, par) PROCMETH_OR_GIVEN(name, par, 0) | |
| 88 #define PROCESS_HAS_METHOD(os, name) the_process_methods.name = os##_##name | |
| 89 | |
| 90 /* | |
| 91 * Structure records pertinent information about open channels. | |
| 92 * There is one channel associated with each process. | |
| 93 */ | |
| 94 | |
| 95 struct Lisp_Process | |
| 96 { | |
|
5127
a9c41067dd88
more cleanups, terminology clarification, lots of doc work
Ben Wing <ben@xemacs.org>
parents:
5124
diff
changeset
|
97 NORMAL_LISP_OBJECT_HEADER header; |
| 428 | 98 |
| 99 /* Exit code if process has terminated, | |
| 100 signal which stopped/interrupted process | |
| 101 or 0 if process is running */ | |
| 102 int exit_code; | |
| 103 /* Non-false if process has exited and "dumped core" on its way down */ | |
| 104 char core_dumped; | |
| 105 | |
| 2297 | 106 /* #### Is this field unused? */ |
| 428 | 107 /* if this flag is not NIL, then filter will do the read on the |
| 108 channel, rather than having a call to make_string. | |
| 109 This only works if the filter is a subr. */ | |
| 110 char filter_does_read; | |
| 853 | 111 /* Non-zero means kill silently if Emacs is exited. */ |
| 428 | 112 char kill_without_query; |
| 853 | 113 char in_selected, err_selected; |
| 428 | 114 /* Event-count of last event in which this process changed status. */ |
| 115 volatile int tick; | |
| 116 /* Event-count of last such event reported. */ | |
| 117 int update_tick; | |
| 853 | 118 /* Non-zero if stderr and stdout are separated. */ |
| 119 char separate_stderr; | |
| 428 | 120 |
| 1204 | 121 #define MARKED_SLOT(x) Lisp_Object x; |
| 122 #include "process-slots.h" | |
| 934 | 123 |
| 428 | 124 /* Implementation dependent data */ |
| 125 void *process_data; | |
| 126 }; | |
| 127 | |
| 128 /* Macros to refer to data connection streams */ | |
| 129 #define DATA_INSTREAM(p) (p)->coding_instream | |
| 130 #define DATA_OUTSTREAM(p) (p)->coding_outstream | |
| 853 | 131 #define DATA_ERRSTREAM(p) (p)->coding_errstream |
| 428 | 132 |
| 133 /* Random externs from process.c */ | |
| 134 extern Lisp_Object Qrun, Qstop, Qopen, Qclosed; | |
| 135 extern Lisp_Object Qtcp, Qudp; | |
| 136 extern Lisp_Object Vprocess_connection_type; | |
| 137 extern Lisp_Object Vprocess_list; | |
| 138 | |
| 139 extern struct hash_table *usid_to_process; | |
| 140 | |
| 141 extern volatile int process_tick; | |
| 142 | |
| 143 extern int windowed_process_io; | |
| 144 | |
| 145 #ifdef PROCESS_IO_BLOCKING | |
| 146 extern Lisp_Object network_stream_blocking_port_list; | |
| 147 #endif /* PROCESS_IO_BLOCKING */ | |
| 148 | |
| 149 Lisp_Object make_process_internal (Lisp_Object name); | |
| 440 | 150 void init_process_io_handles (Lisp_Process *p, void* in, |
| 853 | 151 void* out, void *err, int flags); |
| 428 | 152 void send_process (Lisp_Object proc, |
| 153 Lisp_Object relocatable, | |
| 867 | 154 const Ibyte *nonrelocatable, |
| 428 | 155 int start, int len); |
| 156 | |
| 440 | 157 #endif /* INCLUDED_procimpl_h_ */ |