1 /*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21
22 /*
23 * Copyright 2009 Sun Microsystems, Inc. All rights reserved.
24 * Use is subject to license terms.
25 */
26
27 /*
28 * Copyright 2012 DEY Storage Systems, Inc. All rights reserved.
29 */
30
31 #ifndef _STRUCT_LAYOUT_H
32 #define _STRUCT_LAYOUT_H
33
34 #include <conv.h>
35 #include <_machelf.h>
36
37 /*
38 * Local include file for elfdump, used to define structure layout
39 * definitions for various system structs.
40 */
41
42 #ifdef __cplusplus
43 extern "C" {
44 #endif
45
46
47 /*
48 * Solaris defines system structs that elfdump needs to display
49 * data from. We have a variety of hurdles to overcome in doing this:
50 *
51 * - The size of system types can differ between ELFCLASS32 and
52 * ELFCLASS64.
53 * - Stucture layout can differ between architectures, so a given
54 * field can have a different struct offset than is native
55 * for the system running elfdump. Depending on the struct
56 * in question, the layout for one platform may be impossible
57 * to achieve on another.
58 * - The byte order of the core object can differ from that
59 * of the system running elfdump.
60 *
61 * The result is that in the fully general case, each architecture
62 * can have a slightly different definition of these structures.
63 * The usual approach of assigning a pointer of the desired structure
64 * type and then accessing fields through that pointer cannot be used
65 * here. That approach can only be used to access structures with the
66 * native layout of the elfdump host. We want any instance of elfdump
67 * to be able to examine a Solaris object for any supported architecture,
68 * so we need a more flexible approach.
69 *
70 * The solution to this problem lies in the fact that the binary
71 * layout of these public types cannot be changed, except in backward
72 * compatible ways. They are written to core files or published in
73 * other ways such that we can't make changes that would make it
74 * impossible to analyze old files. This means that we can build
75 * table of offsets and sizes for each field of each struct, on
76 * a per-archecture basis. These tables can be used to access the
77 * struct fields directly from the note desc data, and elfdump
78 * on any host can read the data from any other host.
79 *
80 * When reading these tables, it can be very helpful to examine
81 * the struct definition at the same time.
82 */
83
84 /*
85 * sl_field_t is used to describe a struct field
86 */
87 typedef struct {
88 ushort_t slf_offset; /* Offset from start of struct */
89 ushort_t slf_eltlen; /* Size of datum, in bytes */
90 ushort_t slf_nelts; /* 0 for scalar, # of els for array */
91 uchar_t slf_sign; /* True (1) if signed quantity */
92 } sl_field_t;
93
94 /*
95 * This type is used to extract and manipulate data described by
96 * sl_field_t. We rely on the C guarantee that all the fields in
97 * a union have offset 0.
98 */
99 typedef union {
100 char sld_i8;
101 uchar_t sld_ui8;
102 short sld_i16;
103 ushort_t sld_ui16;
104 int32_t sld_i32;
105 uint32_t sld_ui32;
106 int64_t sld_i64;
107 uint64_t sld_ui64;
108 } sl_data_t;
109
110 /*
111 * Buffer large enough to format any integral value in a field
112 */
113 typedef char sl_fmtbuf_t[CONV_INV_BUFSIZE * 2];
114
115 /*
116 * Types of formatting done by fmt_num()
117 */
118 typedef enum {
119 SL_FMT_NUM_DEC = 0, /* Decimal integer */
120 SL_FMT_NUM_HEX = 1, /* Hex integer, with natural width */
121 SL_FMT_NUM_ZHEX = 2, /* Hex integer, fixed width with zero fill */
122 } sl_fmt_num_t;
123
124
125
126
127 /*
128 * Layout description of auxv_t, from <sys/auxv.h>.
129 */
130 typedef struct {
131 sl_field_t sizeof_struct;
132 sl_field_t a_type;
133 sl_field_t a_val;
134 sl_field_t a_ptr;
135 sl_field_t a_fcn;
136 } sl_auxv_layout_t;
137
138 /*
139 * Layout description of prgregset_t, an architecture specific
140 * array of general register c values
141 */
142 typedef struct {
143 sl_field_t sizeof_struct;
144 sl_field_t elt0;
145 } sl_prgregset_layout_t;
146
147 /*
148 * Layout description of lwpstatus_t, from <sys/procfs.h>.
149 */
150 typedef struct {
151 sl_field_t sizeof_struct;
152 sl_field_t pr_flags;
153 sl_field_t pr_lwpid;
154 sl_field_t pr_why;
155 sl_field_t pr_what;
156 sl_field_t pr_cursig;
157 sl_field_t pr_info;
158 sl_field_t pr_lwppend;
159 sl_field_t pr_lwphold;
160 sl_field_t pr_action;
161 sl_field_t pr_altstack;
162 sl_field_t pr_oldcontext;
163 sl_field_t pr_syscall;
164 sl_field_t pr_nsysarg;
165 sl_field_t pr_errno;
166 sl_field_t pr_sysarg;
167 sl_field_t pr_rval1;
168 sl_field_t pr_rval2;
169 sl_field_t pr_clname;
170 sl_field_t pr_tstamp;
171 sl_field_t pr_utime;
172 sl_field_t pr_stime;
173 sl_field_t pr_errpriv;
174 sl_field_t pr_ustack;
175 sl_field_t pr_instr;
176 sl_field_t pr_reg;
177 sl_field_t pr_fpreg;
178 } sl_lwpstatus_layout_t;
179
180 /*
181 * Layout description of pstatus_t, from <sys/procfs.h>.
182 */
183 typedef struct {
184 sl_field_t sizeof_struct;
185 sl_field_t pr_flags;
186 sl_field_t pr_nlwp;
187 sl_field_t pr_pid;
188 sl_field_t pr_ppid;
189 sl_field_t pr_pgid;
190 sl_field_t pr_sid;
191 sl_field_t pr_aslwpid;
192 sl_field_t pr_agentid;
193 sl_field_t pr_sigpend;
194 sl_field_t pr_brkbase;
195 sl_field_t pr_brksize;
196 sl_field_t pr_stkbase;
197 sl_field_t pr_stksize;
198 sl_field_t pr_utime;
199 sl_field_t pr_stime;
200 sl_field_t pr_cutime;
201 sl_field_t pr_cstime;
202 sl_field_t pr_sigtrace;
203 sl_field_t pr_flttrace;
204 sl_field_t pr_sysentry;
205 sl_field_t pr_sysexit;
206 sl_field_t pr_dmodel;
207 sl_field_t pr_taskid;
208 sl_field_t pr_projid;
209 sl_field_t pr_nzomb;
210 sl_field_t pr_zoneid;
211 sl_field_t pr_lwp;
212 } sl_pstatus_layout_t;
213
214 /*
215 * Layout description of prstatus_t, from <sys/old_procfs.h>.
216 */
217 typedef struct {
218 sl_field_t sizeof_struct;
219 sl_field_t pr_flags;
220 sl_field_t pr_why;
221 sl_field_t pr_what;
222 sl_field_t pr_info;
223 sl_field_t pr_cursig;
224 sl_field_t pr_nlwp;
225 sl_field_t pr_sigpend;
226 sl_field_t pr_sighold;
227 sl_field_t pr_altstack;
228 sl_field_t pr_action;
229 sl_field_t pr_pid;
230 sl_field_t pr_ppid;
231 sl_field_t pr_pgrp;
232 sl_field_t pr_sid;
233 sl_field_t pr_utime;
234 sl_field_t pr_stime;
235 sl_field_t pr_cutime;
236 sl_field_t pr_cstime;
237 sl_field_t pr_clname;
238 sl_field_t pr_syscall;
239 sl_field_t pr_nsysarg;
240 sl_field_t pr_sysarg;
241 sl_field_t pr_who;
242 sl_field_t pr_lwppend;
243 sl_field_t pr_oldcontext;
244 sl_field_t pr_brkbase;
245 sl_field_t pr_brksize;
246 sl_field_t pr_stkbase;
247 sl_field_t pr_stksize;
248 sl_field_t pr_processor;
249 sl_field_t pr_bind;
250 sl_field_t pr_instr;
251 sl_field_t pr_reg;
252 } sl_prstatus_layout_t;
253
254 /*
255 * Layout description of psinfo_t, from <sys/procfs.h>.
256 */
257 typedef struct {
258 sl_field_t sizeof_struct;
259 sl_field_t pr_flag;
260 sl_field_t pr_nlwp;
261 sl_field_t pr_pid;
262 sl_field_t pr_ppid;
263 sl_field_t pr_pgid;
264 sl_field_t pr_sid;
265 sl_field_t pr_uid;
266 sl_field_t pr_euid;
267 sl_field_t pr_gid;
268 sl_field_t pr_egid;
269 sl_field_t pr_addr;
270 sl_field_t pr_size;
271 sl_field_t pr_rssize;
272 sl_field_t pr_ttydev;
273 sl_field_t pr_pctcpu;
274 sl_field_t pr_pctmem;
275 sl_field_t pr_start;
276 sl_field_t pr_time;
277 sl_field_t pr_ctime;
278 sl_field_t pr_fname;
279 sl_field_t pr_psargs;
280 sl_field_t pr_wstat;
281 sl_field_t pr_argc;
282 sl_field_t pr_argv;
283 sl_field_t pr_envp;
284 sl_field_t pr_dmodel;
285 sl_field_t pr_taskid;
286 sl_field_t pr_projid;
287 sl_field_t pr_nzomb;
288 sl_field_t pr_poolid;
289 sl_field_t pr_zoneid;
290 sl_field_t pr_contract;
291 sl_field_t pr_lwp;
292 } sl_psinfo_layout_t;
293
294 /*
295 * Layout description of prpsinfo_t, from <sys/old_procfs.h>.
296 */
297 typedef struct {
298 sl_field_t sizeof_struct;
299 sl_field_t pr_state;
300 sl_field_t pr_sname;
301 sl_field_t pr_zomb;
302 sl_field_t pr_nice;
303 sl_field_t pr_flag;
304 sl_field_t pr_uid;
305 sl_field_t pr_gid;
306 sl_field_t pr_pid;
307 sl_field_t pr_ppid;
308 sl_field_t pr_pgrp;
309 sl_field_t pr_sid;
310 sl_field_t pr_addr;
311 sl_field_t pr_size;
312 sl_field_t pr_rssize;
313 sl_field_t pr_wchan;
314 sl_field_t pr_start;
315 sl_field_t pr_time;
316 sl_field_t pr_pri;
317 sl_field_t pr_oldpri;
318 sl_field_t pr_cpu;
319 sl_field_t pr_ottydev;
320 sl_field_t pr_lttydev;
321 sl_field_t pr_clname;
322 sl_field_t pr_fname;
323 sl_field_t pr_psargs;
324 sl_field_t pr_syscall;
325 sl_field_t pr_ctime;
326 sl_field_t pr_bysize;
327 sl_field_t pr_byrssize;
328 sl_field_t pr_argc;
329 sl_field_t pr_argv;
330 sl_field_t pr_envp;
331 sl_field_t pr_wstat;
332 sl_field_t pr_pctcpu;
333 sl_field_t pr_pctmem;
334 sl_field_t pr_euid;
335 sl_field_t pr_egid;
336 sl_field_t pr_aslwpid;
337 sl_field_t pr_dmodel;
338 } sl_prpsinfo_layout_t;
339
340 /*
341 * Layout description of lwpsinfo_t, from <sys/procfs.h>.
342 */
343 typedef struct {
344 sl_field_t sizeof_struct;
345 sl_field_t pr_flag;
346 sl_field_t pr_lwpid;
347 sl_field_t pr_addr;
348 sl_field_t pr_wchan;
349 sl_field_t pr_stype;
350 sl_field_t pr_state;
351 sl_field_t pr_sname;
352 sl_field_t pr_nice;
353 sl_field_t pr_syscall;
354 sl_field_t pr_oldpri;
355 sl_field_t pr_cpu;
356 sl_field_t pr_pri;
357 sl_field_t pr_pctcpu;
358 sl_field_t pr_start;
359 sl_field_t pr_time;
360 sl_field_t pr_clname;
361 sl_field_t pr_name;
362 sl_field_t pr_onpro;
363 sl_field_t pr_bindpro;
364 sl_field_t pr_bindpset;
365 sl_field_t pr_lgrp;
366 } sl_lwpsinfo_layout_t;
367
368 /*
369 * Layout description of prcred_t, from <sys/procfs.h>.
370 */
371 typedef struct {
372 sl_field_t sizeof_struct;
373 sl_field_t pr_euid;
374 sl_field_t pr_ruid;
375 sl_field_t pr_suid;
376 sl_field_t pr_egid;
377 sl_field_t pr_rgid;
378 sl_field_t pr_sgid;
379 sl_field_t pr_ngroups;
380 sl_field_t pr_groups;
381 } sl_prcred_layout_t;
382
383 /*
384 * Layout description of prpriv_t, from <sys/procfs.h>.
385 */
386 typedef struct {
387 sl_field_t sizeof_struct;
388 sl_field_t pr_nsets;
389 sl_field_t pr_setsize;
390 sl_field_t pr_infosize;
391 sl_field_t pr_sets;
392 } sl_prpriv_layout_t;
393
394 /*
395 * Layout description of priv_impl_info_t, from <sys/priv.h>.
396 */
397 typedef struct {
398 sl_field_t sizeof_struct;
399 sl_field_t priv_headersize;
400 sl_field_t priv_flags;
401 sl_field_t priv_nsets;
402 sl_field_t priv_setsize;
403 sl_field_t priv_max;
404 sl_field_t priv_infosize;
405 sl_field_t priv_globalinfosize;
406 } sl_priv_impl_info_layout_t;
407
408 /*
409 * Layout description of fltset_t, from <sys/fault.h>.
410 */
411 typedef struct {
412 sl_field_t sizeof_struct;
413 sl_field_t word;
414 } sl_fltset_layout_t;
415
416 /*
417 * Layout description of siginfo_t, from <sys/siginfo.h>.
418 *
419 * siginfo_t is unusual, in that it contains a large union
420 * full of private fields. There are macros defined to give
421 * access to these fields via the names documented in the
422 * siginfo manpage. We stick to the documented names
423 * rather than try to unravel the undocumented blob. Hence,
424 * the layout description below is a "logical" view of siginfo_t.
425 * The fields below are not necessarily in the same order as
426 * they appear in siginfo_t, nor are they everything that is in
427 * that struct. They may also overlap each other, if they are
428 * contained within of the union.
429 *
430 * The f_ prefixes are used to prevent our field names from
431 * clashing with the macros defined in siginfo.h.
432 */
433 typedef struct {
434 sl_field_t sizeof_struct;
435 sl_field_t f_si_signo;
436 sl_field_t f_si_errno;
437 sl_field_t f_si_code;
438 sl_field_t f_si_value_int;
439 sl_field_t f_si_value_ptr;
440 sl_field_t f_si_pid;
441 sl_field_t f_si_uid;
442 sl_field_t f_si_ctid;
443 sl_field_t f_si_zoneid;
444 sl_field_t f_si_entity;
445 sl_field_t f_si_addr;
446 sl_field_t f_si_status;
447 sl_field_t f_si_band;
448 } sl_siginfo_layout_t;
449
450 /*
451 * Layout description of sigset_t, from <sys/signal.h>.
452 */
453 typedef struct {
454 sl_field_t sizeof_struct;
455 sl_field_t sigbits;
456 } sl_sigset_layout_t;
457
458 /*
459 * Layout description of struct sigaction, from <sys/signal.h>.
460 */
461 typedef struct {
462 sl_field_t sizeof_struct;
463 sl_field_t sa_flags;
464 sl_field_t sa_hand;
465 sl_field_t sa_sigact;
466 sl_field_t sa_mask;
467 } sl_sigaction_layout_t;
468
469 /*
470 * Layout description of stack_t, from <sys/signal.h>.
471 */
472 typedef struct {
473 sl_field_t sizeof_struct;
474 sl_field_t ss_sp;
475 sl_field_t ss_size;
476 sl_field_t ss_flags;
477 } sl_stack_layout_t;
478
479 /*
480 * Layout description of sysset_t, from <sys/syscall.h>.
481 */
482 typedef struct {
483 sl_field_t sizeof_struct;
484 sl_field_t word;
485 } sl_sysset_layout_t;
486
487 /*
488 * Layout description of timestruc_t, from <sys/time_impl.h>.
489 */
490 typedef struct {
491 sl_field_t sizeof_struct;
492 sl_field_t tv_sec;
493 sl_field_t tv_nsec;
494 } sl_timestruc_layout_t;
495
496 /*
497 * Layout description of struct utsname, from <sys/utsname.h>.
498 */
499 typedef struct {
500 sl_field_t sizeof_struct;
501 sl_field_t sysname;
502 sl_field_t nodename;
503 sl_field_t release;
504 sl_field_t version;
505 sl_field_t machine;
506 } sl_utsname_layout_t;
507
508 /*
509 * Layout description of prdinfo_t, from <sys/procfs.h>.
510 */
511 typedef struct {
512 sl_field_t sizeof_struct;
513 sl_field_t pr_fd;
514 sl_field_t pr_mode;
515 sl_field_t pr_uid;
516 sl_field_t pr_gid;
517 sl_field_t pr_major;
518 sl_field_t pr_minor;
519 sl_field_t pr_rmajor;
520 sl_field_t pr_rminor;
521 sl_field_t pr_ino;
522 sl_field_t pr_offset;
523 sl_field_t pr_size;
524 sl_field_t pr_fileflags;
525 sl_field_t pr_fdflags;
526 sl_field_t pr_path;
527 } sl_prfdinfo_layout_t;
528
529 /*
530 * This type collects all of the layout definitions for
531 * a given architecture.
532 */
533 typedef struct {
534 const sl_auxv_layout_t *auxv; /* auxv_t */
535 const sl_fltset_layout_t *fltset; /* fltset_t */
536 const sl_lwpsinfo_layout_t *lwpsinfo; /* lwpsinfo_t */
537 const sl_lwpstatus_layout_t *lwpstatus; /* lwpstatus_t */
538 const sl_prcred_layout_t *prcred; /* prcred_t */
539 const sl_priv_impl_info_layout_t *priv_impl_info; /* priv_impl_info_t */
540 const sl_prpriv_layout_t *prpriv; /* prpriv_t */
541 const sl_psinfo_layout_t *psinfo; /* psinfo_t */
542 const sl_pstatus_layout_t *pstatus; /* pstatus_t */
543 const sl_prgregset_layout_t *prgregset; /* prgregset_t */
544 const sl_prpsinfo_layout_t *prpsinfo; /* prpsinfo_t */
545 const sl_prstatus_layout_t *prstatus; /* prstatus_t */
546 const sl_sigaction_layout_t *sigaction; /* struct sigaction */
547 const sl_siginfo_layout_t *siginfo; /* siginfo_t */
548 const sl_sigset_layout_t *sigset; /* sigset_t */
549 const sl_stack_layout_t *stack; /* stack_t */
550 const sl_sysset_layout_t *sysset; /* sysset_t */
551 const sl_timestruc_layout_t *timestruc; /* timestruc_t */
552 const sl_utsname_layout_t *utsname; /* struct utsname */
553 const sl_prfdinfo_layout_t *prfdinfo; /* prdinfo_t */
554 } sl_arch_layout_t;
555
556
557
558 extern void sl_extract_num_field(const char *data, int do_swap,
559 const sl_field_t *fdesc, sl_data_t *field_data);
560 extern Word sl_extract_as_word(const char *data, int do_swap,
561 const sl_field_t *fdesc);
562 extern Lword sl_extract_as_lword(const char *data, int do_swap,
563 const sl_field_t *fdesc);
564 extern Sword sl_extract_as_sword(const char *data, int do_swap,
565 const sl_field_t *fdesc);
566 extern const char *sl_fmt_num(const char *data, int do_swap,
567 const sl_field_t *fdesc, sl_fmt_num_t fmt_type,
568 sl_fmtbuf_t buf);
569
570
571 extern const sl_arch_layout_t *sl_mach(Half);
572 extern const sl_arch_layout_t *struct_layout_i386(void);
573 extern const sl_arch_layout_t *struct_layout_amd64(void);
574 extern const sl_arch_layout_t *struct_layout_sparc(void);
575 extern const sl_arch_layout_t *struct_layout_sparcv9(void);
576
577
578
579 #ifdef __cplusplus
580 }
581 #endif
582
583 #endif /* _STRUCT_LAYOUT_H */