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.
32 * Date: Tue Mar 2 1982
33 * Originally under the name unexec.c.
34 * Modified heavily since then.
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
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.
78 #define PERROR(file) report_error (file, new)
80 #ifndef CANNOT_DUMP /* all rest of file! */
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
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 */
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>
119 #include <sys/stat.h>
122 #include <sys/file.h>
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
;
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)
158 report_error (const char *file
, int 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
170 report_error_1 (int fd
, const char *msg
, int a1
, int 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 /* ****************************************************************
185 * Make the header in the new a.out from the header in core.
186 * Modify the text and data sizes.
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 */
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. */
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",
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 */
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
))
244 if (mz_header
[0] == 0x5a4d || mz_header
[0] == 0x4d5a) /* "MZ" or "ZM" */
246 coff_offset
= (long)mz_header
[2] * 512L;
248 coff_offset
+= (long)mz_header
[1] - 512L;
249 lseek (a_out
, coff_offset
, 0);
252 lseek (a_out
, 0L, 0);
254 if (read (a_out
, &f_hdr
, sizeof (f_hdr
)) != sizeof (f_hdr
))
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
))
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
))
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)
283 else if (strcmp (scntemp
.s_name
, ".data") == 0)
287 else if (strcmp (scntemp
.s_name
, ".bss") == 0)
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
))
335 if (write (new, &f_ohdr
, sizeof (f_ohdr
)) != sizeof (f_ohdr
))
340 if (write (new, &f_thdr
, sizeof (f_thdr
)) != sizeof (f_thdr
))
345 if (write (new, &f_dhdr
, sizeof (f_dhdr
)) != sizeof (f_dhdr
))
350 if (write (new, &f_bhdr
, sizeof (f_bhdr
)) != sizeof (f_bhdr
))
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 ();
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. */
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
)
393 write (new, zeros
, nwrite
);
399 /* ****************************************************************
402 * Copy the text and data segments from memory to the new a.out
405 copy_text_and_data (int new, int a_out
)
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
);
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
);
432 /* Restore our exception hooks. */
433 __djgpp_exception_toggle ();
435 /* Restore the startup flags. */
436 _crt0_startup_flags
= save_djgpp_startup_flags
;
443 /* ****************************************************************
446 * Copy the relocation information and symbol table from the a.out to the new
449 copy_sym (int new, int a_out
, const char *a_name
, const char *new_name
)
457 if (SYMS_START
== 0L)
460 if (lnnoptr
) /* if there is line number info */
461 lseek (a_out
, coff_offset
+ lnnoptr
, 0); /* start copying from there */
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
)
479 /* ****************************************************************
482 * After successfully building the new a.out, mark it executable
485 mark_x (const char *name
)
489 int new = 0; /* for PERROR */
493 if (stat (name
, &sbuf
) == -1)
497 sbuf
.st_mode
|= 0111 & ~um
;
498 if (chmod (name
, sbuf
.st_mode
) == -1)
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
)
530 struct syment symentry
;
531 union auxent auxentry
;
533 if (!lnnoptr
|| !f_hdr
.f_symptr
)
537 if ((new = writedesc
) < 0)
539 if ((new = open (new_name
, O_RDWR
)) < 0)
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
);
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
);
568 /* ****************************************************************
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)
583 if ((new = creat (new_name
, 0666)) < 0)
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
605 #endif /* not CANNOT_DUMP */
607 /* arch-tag: 62409b69-e27a-4a7c-9413-0210d6b54e7f
608 (do not change this comment) */