Merge changes made in Gnus trunk.
[emacs.git] / src / unexcoff.c
blobcb4b8d603b523f61cc760997d906cc90073d640f
1 /* Copyright (C) 1985, 1986, 1987, 1988, 1992, 1993, 1994, 2001, 2002, 2003,
2 2004, 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
4 This file is part of GNU Emacs.
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
8 the Free Software Foundation, either version 3 of the License, or
9 (at your option) any later version.
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.
16 You should have received a copy of the GNU General Public License
17 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. */
21 * unexcoff.c - Convert a running program into an a.out or COFF file.
23 * ==================================================================
24 * Note: This file is currently used only by the MSDOS (a.k.a. DJGPP)
25 * build of Emacs. If you are not interested in the MSDOS build, you
26 * are looking at the wrong version of unexec!
27 * ==================================================================
29 * Author: Spencer W. Thomas
30 * Computer Science Dept.
31 * University of Utah
32 * Date: Tue Mar 2 1982
33 * Originally under the name unexec.c.
34 * Modified heavily since then.
36 * Synopsis:
37 * unexec (new_name, a_name, data_start, bss_start, entry_address)
38 * char *new_name, *a_name;
39 * unsigned data_start, bss_start, entry_address;
41 * Takes a snapshot of the program and makes an a.out format file in the
42 * file named by the string argument new_name.
43 * If a_name is non-NULL, the symbol table will be taken from the given file.
44 * On some machines, an existing a_name file is required.
46 * The boundaries within the a.out file may be adjusted with the data_start
47 * and bss_start arguments. Either or both may be given as 0 for defaults.
49 * Data_start gives the boundary between the text segment and the data
50 * segment of the program. The text segment can contain shared, read-only
51 * program code and literal data, while the data segment is always unshared
52 * and unprotected. Data_start gives the lowest unprotected address.
53 * The value you specify may be rounded down to a suitable boundary
54 * as required by the machine you are using.
56 * Specifying zero for data_start means the boundary between text and data
57 * should not be the same as when the program was loaded.
59 * Bss_start indicates how much of the data segment is to be saved in the
60 * a.out file and restored when the program is executed. It gives the lowest
61 * unsaved address, and is rounded up to a page boundary. The default when 0
62 * is given assumes that the entire data segment is to be stored, including
63 * the previous data and bss as well as any additional storage allocated with
64 * break (2).
66 * The new file is set up to start at entry_address.
68 * If you make improvements I'd like to get them too.
69 * harpo!utah-cs!thomas, thomas@Utah-20
73 /* Modified to support SysVr3 shared libraries by James Van Artsdalen
74 * of Dell Computer Corporation. james@bigtex.cactus.org.
77 #include <config.h>
78 #define PERROR(file) report_error (file, new)
80 #ifndef CANNOT_DUMP /* all rest of file! */
82 #ifdef HAVE_COFF_H
83 #include <coff.h>
84 #ifdef MSDOS
85 #include <fcntl.h> /* for O_RDONLY, O_RDWR */
86 #include <crt0.h> /* for _crt0_startup_flags and its bits */
87 #include <sys/exceptn.h>
88 static int save_djgpp_startup_flags;
89 #define filehdr external_filehdr
90 #define scnhdr external_scnhdr
91 #define syment external_syment
92 #define auxent external_auxent
93 #define n_numaux e_numaux
94 #define n_type e_type
95 struct aouthdr
97 unsigned short magic; /* type of file */
98 unsigned short vstamp; /* version stamp */
99 unsigned long tsize; /* text size in bytes, padded to FW bdry*/
100 unsigned long dsize; /* initialized data " " */
101 unsigned long bsize; /* uninitialized data " " */
102 unsigned long entry; /* entry pt. */
103 unsigned long text_start;/* base of text used for this file */
104 unsigned long data_start;/* base of data used for this file */
106 #endif /* not MSDOS */
107 #else /* not HAVE_COFF_H */
108 #include <a.out.h>
109 #endif /* not HAVE_COFF_H */
111 /* Define getpagesize if the system does not.
112 Note that this may depend on symbols defined in a.out.h. */
113 #include "getpagesize.h"
115 #ifndef makedev /* Try to detect types.h already loaded */
116 #include <sys/types.h>
117 #endif /* makedev */
118 #include <stdio.h>
119 #include <sys/stat.h>
120 #include <errno.h>
122 #include <sys/file.h>
124 #ifndef O_RDONLY
125 #define O_RDONLY 0
126 #endif
127 #ifndef O_RDWR
128 #define O_RDWR 2
129 #endif
132 extern char *start_of_data (void); /* Start of initialized data */
134 static long block_copy_start; /* Old executable start point */
135 static struct filehdr f_hdr; /* File header */
136 static struct aouthdr f_ohdr; /* Optional file header (a.out) */
137 long bias; /* Bias to add for growth */
138 long lnnoptr; /* Pointer to line-number info within file */
139 #define SYMS_START block_copy_start
141 static long text_scnptr;
142 static long data_scnptr;
144 static long coff_offset;
146 static int pagemask;
148 /* Correct an int which is the bit pattern of a pointer to a byte
149 into an int which is the number of a byte.
150 This is a no-op on ordinary machines, but not on all. */
152 #define ADDR_CORRECT(x) ((char *)(x) - (char*)0)
154 #include <setjmp.h>
155 #include "lisp.h"
157 static void
158 report_error (const char *file, int fd)
160 if (fd)
161 close (fd);
162 report_file_error ("Cannot unexec", Fcons (build_string (file), Qnil));
165 #define ERROR0(msg) report_error_1 (new, msg, 0, 0); return -1
166 #define ERROR1(msg,x) report_error_1 (new, msg, x, 0); return -1
167 #define ERROR2(msg,x,y) report_error_1 (new, msg, x, y); return -1
169 static void
170 report_error_1 (int fd, const char *msg, int a1, int a2)
172 close (fd);
173 error (msg, a1, a2);
176 static int make_hdr (int, int, unsigned, unsigned, unsigned,
177 const char *, const char *);
178 static int copy_text_and_data (int, int);
179 static int copy_sym (int, int, const char *, const char *);
180 static void mark_x (const char *);
182 /* ****************************************************************
183 * make_hdr
185 * Make the header in the new a.out from the header in core.
186 * Modify the text and data sizes.
188 static int
189 make_hdr (int new, int a_out, unsigned data_start, unsigned bss_start,
190 unsigned entry_address, const char *a_name, const char *new_name)
192 auto struct scnhdr f_thdr; /* Text section header */
193 auto struct scnhdr f_dhdr; /* Data section header */
194 auto struct scnhdr f_bhdr; /* Bss section header */
195 auto struct scnhdr scntemp; /* Temporary section header */
196 register int scns;
197 unsigned int bss_end;
199 pagemask = getpagesize () - 1;
201 /* Adjust text/data boundary. */
202 data_start = (int) start_of_data ();
203 data_start = ADDR_CORRECT (data_start);
204 data_start = data_start & ~pagemask; /* (Down) to page boundary. */
206 bss_end = ADDR_CORRECT (sbrk (0)) + pagemask;
207 bss_end &= ~ pagemask;
209 /* Adjust data/bss boundary. */
210 if (bss_start != 0)
212 bss_start = (ADDR_CORRECT (bss_start) + pagemask);
213 /* (Up) to page bdry. */
214 bss_start &= ~ pagemask;
215 if (bss_start > bss_end)
217 ERROR1 ("unexec: Specified bss_start (%u) is past end of program",
218 bss_start);
221 else
222 bss_start = bss_end;
224 if (data_start > bss_start) /* Can't have negative data size. */
226 ERROR2 ("unexec: data_start (%u) can't be greater than bss_start (%u)",
227 data_start, bss_start);
230 coff_offset = 0L; /* stays zero, except in DJGPP */
232 /* Salvage as much info from the existing file as possible */
233 if (a_out >= 0)
235 #ifdef MSDOS
236 /* Support the coff-go32-exe format with a prepended stub, since
237 this is what GCC 2.8.0 and later generates by default in DJGPP. */
238 unsigned short mz_header[3];
240 if (read (a_out, &mz_header, sizeof (mz_header)) != sizeof (mz_header))
242 PERROR (a_name);
244 if (mz_header[0] == 0x5a4d || mz_header[0] == 0x4d5a) /* "MZ" or "ZM" */
246 coff_offset = (long)mz_header[2] * 512L;
247 if (mz_header[1])
248 coff_offset += (long)mz_header[1] - 512L;
249 lseek (a_out, coff_offset, 0);
251 else
252 lseek (a_out, 0L, 0);
253 #endif /* MSDOS */
254 if (read (a_out, &f_hdr, sizeof (f_hdr)) != sizeof (f_hdr))
256 PERROR (a_name);
258 block_copy_start += sizeof (f_hdr);
259 if (f_hdr.f_opthdr > 0)
261 if (read (a_out, &f_ohdr, sizeof (f_ohdr)) != sizeof (f_ohdr))
263 PERROR (a_name);
265 block_copy_start += sizeof (f_ohdr);
267 /* Loop through section headers, copying them in */
268 lseek (a_out, coff_offset + sizeof (f_hdr) + f_hdr.f_opthdr, 0);
269 for (scns = f_hdr.f_nscns; scns > 0; scns--) {
270 if (read (a_out, &scntemp, sizeof (scntemp)) != sizeof (scntemp))
272 PERROR (a_name);
274 if (scntemp.s_scnptr > 0L)
276 if (block_copy_start < scntemp.s_scnptr + scntemp.s_size)
277 block_copy_start = scntemp.s_scnptr + scntemp.s_size;
279 if (strcmp (scntemp.s_name, ".text") == 0)
281 f_thdr = scntemp;
283 else if (strcmp (scntemp.s_name, ".data") == 0)
285 f_dhdr = scntemp;
287 else if (strcmp (scntemp.s_name, ".bss") == 0)
289 f_bhdr = scntemp;
293 else
295 ERROR0 ("can't build a COFF file from scratch yet");
298 /* Now we alter the contents of all the f_*hdr variables
299 to correspond to what we want to dump. */
301 f_hdr.f_flags |= (F_RELFLG | F_EXEC);
302 f_ohdr.dsize = bss_start - f_ohdr.data_start;
303 f_ohdr.bsize = bss_end - bss_start;
304 f_thdr.s_size = f_ohdr.tsize;
305 f_thdr.s_scnptr = sizeof (f_hdr) + sizeof (f_ohdr);
306 f_thdr.s_scnptr += (f_hdr.f_nscns) * (sizeof (f_thdr));
307 lnnoptr = f_thdr.s_lnnoptr;
308 text_scnptr = f_thdr.s_scnptr;
309 f_dhdr.s_paddr = f_ohdr.data_start;
310 f_dhdr.s_vaddr = f_ohdr.data_start;
311 f_dhdr.s_size = f_ohdr.dsize;
312 f_dhdr.s_scnptr = f_thdr.s_scnptr + f_thdr.s_size;
313 data_scnptr = f_dhdr.s_scnptr;
314 f_bhdr.s_paddr = f_ohdr.data_start + f_ohdr.dsize;
315 f_bhdr.s_vaddr = f_ohdr.data_start + f_ohdr.dsize;
316 f_bhdr.s_size = f_ohdr.bsize;
317 f_bhdr.s_scnptr = 0L;
318 bias = f_dhdr.s_scnptr + f_dhdr.s_size - block_copy_start;
320 if (f_hdr.f_symptr > 0L)
322 f_hdr.f_symptr += bias;
325 if (f_thdr.s_lnnoptr > 0L)
327 f_thdr.s_lnnoptr += bias;
330 if (write (new, &f_hdr, sizeof (f_hdr)) != sizeof (f_hdr))
332 PERROR (new_name);
335 if (write (new, &f_ohdr, sizeof (f_ohdr)) != sizeof (f_ohdr))
337 PERROR (new_name);
340 if (write (new, &f_thdr, sizeof (f_thdr)) != sizeof (f_thdr))
342 PERROR (new_name);
345 if (write (new, &f_dhdr, sizeof (f_dhdr)) != sizeof (f_dhdr))
347 PERROR (new_name);
350 if (write (new, &f_bhdr, sizeof (f_bhdr)) != sizeof (f_bhdr))
352 PERROR (new_name);
355 return (0);
359 void
360 write_segment (int new, const char *ptr, const char *end)
362 register int i, nwrite, ret;
363 /* This is the normal amount to write at once.
364 It is the size of block that NFS uses. */
365 int writesize = 1 << 13;
366 int pagesize = getpagesize ();
367 char zeros[1 << 13];
369 memset (zeros, 0, sizeof (zeros));
371 for (i = 0; ptr < end;)
373 /* Distance to next multiple of writesize. */
374 nwrite = (((int) ptr + writesize) & -writesize) - (int) ptr;
375 /* But not beyond specified end. */
376 if (nwrite > end - ptr) nwrite = end - ptr;
377 ret = write (new, ptr, nwrite);
378 /* If write gets a page fault, it means we reached
379 a gap between the old text segment and the old data segment.
380 This gap has probably been remapped into part of the text segment.
381 So write zeros for it. */
382 if (ret == -1
383 #ifdef EFAULT
384 && errno == EFAULT
385 #endif
388 /* Write only a page of zeros at once,
389 so that we don't overshoot the start
390 of the valid memory in the old data segment. */
391 if (nwrite > pagesize)
392 nwrite = pagesize;
393 write (new, zeros, nwrite);
395 i += nwrite;
396 ptr += nwrite;
399 /* ****************************************************************
400 * copy_text_and_data
402 * Copy the text and data segments from memory to the new a.out
404 static int
405 copy_text_and_data (int new, int a_out)
407 register char *end;
408 register char *ptr;
410 #ifdef MSDOS
411 /* Dump the original table of exception handlers, not the one
412 where our exception hooks are registered. */
413 __djgpp_exception_toggle ();
415 /* Switch off startup flags that might have been set at runtime
416 and which might change the way that dumped Emacs works. */
417 save_djgpp_startup_flags = _crt0_startup_flags;
418 _crt0_startup_flags &= ~(_CRT0_FLAG_NO_LFN | _CRT0_FLAG_NEARPTR);
419 #endif
421 lseek (new, (long) text_scnptr, 0);
422 ptr = (char *) f_ohdr.text_start;
423 end = ptr + f_ohdr.tsize;
424 write_segment (new, ptr, end);
426 lseek (new, (long) data_scnptr, 0);
427 ptr = (char *) f_ohdr.data_start;
428 end = ptr + f_ohdr.dsize;
429 write_segment (new, ptr, end);
431 #ifdef MSDOS
432 /* Restore our exception hooks. */
433 __djgpp_exception_toggle ();
435 /* Restore the startup flags. */
436 _crt0_startup_flags = save_djgpp_startup_flags;
437 #endif
440 return 0;
443 /* ****************************************************************
444 * copy_sym
446 * Copy the relocation information and symbol table from the a.out to the new
448 static int
449 copy_sym (int new, int a_out, const char *a_name, const char *new_name)
451 char page[1024];
452 int n;
454 if (a_out < 0)
455 return 0;
457 if (SYMS_START == 0L)
458 return 0;
460 if (lnnoptr) /* if there is line number info */
461 lseek (a_out, coff_offset + lnnoptr, 0); /* start copying from there */
462 else
463 lseek (a_out, coff_offset + SYMS_START, 0); /* Position a.out to symtab. */
465 while ((n = read (a_out, page, sizeof page)) > 0)
467 if (write (new, page, n) != n)
469 PERROR (new_name);
472 if (n < 0)
474 PERROR (a_name);
476 return 0;
479 /* ****************************************************************
480 * mark_x
482 * After successfully building the new a.out, mark it executable
484 static void
485 mark_x (const char *name)
487 struct stat sbuf;
488 int um;
489 int new = 0; /* for PERROR */
491 um = umask (777);
492 umask (um);
493 if (stat (name, &sbuf) == -1)
495 PERROR (name);
497 sbuf.st_mode |= 0111 & ~um;
498 if (chmod (name, sbuf.st_mode) == -1)
499 PERROR (name);
504 * If the COFF file contains a symbol table and a line number section,
505 * then any auxiliary entries that have values for x_lnnoptr must
506 * be adjusted by the amount that the line number section has moved
507 * in the file (bias computed in make_hdr). The #@$%&* designers of
508 * the auxiliary entry structures used the absolute file offsets for
509 * the line number entry rather than an offset from the start of the
510 * line number section!
512 * When I figure out how to scan through the symbol table and pick out
513 * the auxiliary entries that need adjustment, this routine will
514 * be fixed. As it is now, all such entries are wrong and sdb
515 * will complain. Fred Fish, UniSoft Systems Inc.
518 /* This function is probably very slow. Instead of reopening the new
519 file for input and output it should copy from the old to the new
520 using the two descriptors already open (WRITEDESC and READDESC).
521 Instead of reading one small structure at a time it should use
522 a reasonable size buffer. But I don't have time to work on such
523 things, so I am installing it as submitted to me. -- RMS. */
526 adjust_lnnoptrs (int writedesc, int readdesc, const char *new_name)
528 register int nsyms;
529 register int new;
530 struct syment symentry;
531 union auxent auxentry;
533 if (!lnnoptr || !f_hdr.f_symptr)
534 return 0;
536 #ifdef MSDOS
537 if ((new = writedesc) < 0)
538 #else
539 if ((new = open (new_name, O_RDWR)) < 0)
540 #endif
542 PERROR (new_name);
543 return -1;
546 lseek (new, f_hdr.f_symptr, 0);
547 for (nsyms = 0; nsyms < f_hdr.f_nsyms; nsyms++)
549 read (new, &symentry, SYMESZ);
550 if (symentry.n_numaux)
552 read (new, &auxentry, AUXESZ);
553 nsyms++;
554 if (ISFCN (symentry.n_type) || symentry.n_type == 0x2400)
556 auxentry.x_sym.x_fcnary.x_fcn.x_lnnoptr += bias;
557 lseek (new, -AUXESZ, 1);
558 write (new, &auxentry, AUXESZ);
562 #ifndef MSDOS
563 close (new);
564 #endif
565 return 0;
568 /* ****************************************************************
569 * unexec
571 * driving logic.
574 unexec (const char *new_name, const char *a_name,
575 unsigned data_start, unsigned bss_start, unsigned entry_address)
577 int new = -1, a_out = -1;
579 if (a_name && (a_out = open (a_name, O_RDONLY)) < 0)
581 PERROR (a_name);
583 if ((new = creat (new_name, 0666)) < 0)
585 PERROR (new_name);
588 if (make_hdr (new, a_out, data_start, bss_start, entry_address, a_name, new_name) < 0
589 || copy_text_and_data (new, a_out) < 0
590 || copy_sym (new, a_out, a_name, new_name) < 0
591 || adjust_lnnoptrs (new, a_out, new_name) < 0
594 close (new);
595 return -1;
598 close (new);
599 if (a_out >= 0)
600 close (a_out);
601 mark_x (new_name);
602 return 0;
605 #endif /* not CANNOT_DUMP */
607 /* arch-tag: 62409b69-e27a-4a7c-9413-0210d6b54e7f
608 (do not change this comment) */