The Design and Implementation of the FreeBSD Operating System, Second Edition
Now available: The Design and Implementation of the FreeBSD Operating System (Second Edition)


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]

FreeBSD/Linux Kernel Cross Reference
sys/sys/kerneldump.h

Version: -  FREEBSD  -  FREEBSD-12-STABLE  -  FREEBSD-12-0  -  FREEBSD-11-STABLE  -  FREEBSD-11-2  -  FREEBSD-11-1  -  FREEBSD-11-0  -  FREEBSD-10-STABLE  -  FREEBSD-10-4  -  FREEBSD-10-3  -  FREEBSD-10-2  -  FREEBSD-10-1  -  FREEBSD-10-0  -  FREEBSD-9-STABLE  -  FREEBSD-9-3  -  FREEBSD-9-2  -  FREEBSD-9-1  -  FREEBSD-9-0  -  FREEBSD-8-STABLE  -  FREEBSD-8-4  -  FREEBSD-8-3  -  FREEBSD-8-2  -  FREEBSD-8-1  -  FREEBSD-8-0  -  FREEBSD-7-STABLE  -  FREEBSD-7-4  -  FREEBSD-7-3  -  FREEBSD-7-2  -  FREEBSD-7-1  -  FREEBSD-7-0  -  FREEBSD-6-STABLE  -  FREEBSD-6-4  -  FREEBSD-6-3  -  FREEBSD-6-2  -  FREEBSD-6-1  -  FREEBSD-6-0  -  FREEBSD-5-STABLE  -  FREEBSD-5-5  -  FREEBSD-5-4  -  FREEBSD-5-3  -  FREEBSD-5-2  -  FREEBSD-5-1  -  FREEBSD-5-0  -  FREEBSD-4-STABLE  -  FREEBSD-3-STABLE  -  FREEBSD22  -  linux-2.6  -  linux-2.4.22  -  MK83  -  MK84  -  PLAN9  -  DFBSD  -  NETBSD  -  NETBSD5  -  NETBSD4  -  NETBSD3  -  NETBSD20  -  OPENBSD  -  xnu-517  -  xnu-792  -  xnu-792.6.70  -  xnu-1228  -  xnu-1456.1.26  -  xnu-1699.24.8  -  xnu-2050.18.24  -  OPENSOLARIS  -  minix-3-1-1 
SearchContext: -  none  -  3  -  10 

    1 /*-
    2  * SPDX-License-Identifier: BSD-3-Clause
    3  *
    4  * Copyright (c) 2002 Poul-Henning Kamp
    5  * Copyright (c) 2002 Networks Associates Technology, Inc.
    6  * All rights reserved.
    7  *
    8  * This software was developed for the FreeBSD Project by Poul-Henning Kamp
    9  * and NAI Labs, the Security Research Division of Network Associates, Inc.
   10  * under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part of the
   11  * DARPA CHATS research program.
   12  *
   13  * Redistribution and use in source and binary forms, with or without
   14  * modification, are permitted provided that the following conditions
   15  * are met:
   16  * 1. Redistributions of source code must retain the above copyright
   17  *    notice, this list of conditions and the following disclaimer.
   18  * 2. Redistributions in binary form must reproduce the above copyright
   19  *    notice, this list of conditions and the following disclaimer in the
   20  *    documentation and/or other materials provided with the distribution.
   21  * 3. The names of the authors may not be used to endorse or promote
   22  *    products derived from this software without specific prior written
   23  *    permission.
   24  *
   25  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
   26  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
   27  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
   28  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
   29  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
   30  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
   31  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
   32  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
   33  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
   34  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
   35  * SUCH DAMAGE.
   36  *
   37  * $FreeBSD: releng/12.0/sys/sys/kerneldump.h 335227 2018-06-15 19:02:53Z cem $
   38  */
   39 
   40 #ifndef _SYS_KERNELDUMP_H
   41 #define _SYS_KERNELDUMP_H
   42 
   43 #include <sys/param.h>
   44 #include <sys/conf.h>
   45 
   46 #include <machine/endian.h>
   47 
   48 #if BYTE_ORDER == LITTLE_ENDIAN
   49 #define dtoh32(x)       __bswap32(x)
   50 #define dtoh64(x)       __bswap64(x)
   51 #define htod32(x)       __bswap32(x)
   52 #define htod64(x)       __bswap64(x)
   53 #elif BYTE_ORDER == BIG_ENDIAN
   54 #define dtoh32(x)       (x)
   55 #define dtoh64(x)       (x)
   56 #define htod32(x)       (x)
   57 #define htod64(x)       (x)
   58 #endif
   59 
   60 #define KERNELDUMP_COMP_NONE            0
   61 #define KERNELDUMP_COMP_GZIP            1
   62 #define KERNELDUMP_COMP_ZSTD            2
   63 
   64 #define KERNELDUMP_ENC_NONE             0
   65 #define KERNELDUMP_ENC_AES_256_CBC      1
   66 
   67 #define KERNELDUMP_BUFFER_SIZE          4096
   68 #define KERNELDUMP_IV_MAX_SIZE          32
   69 #define KERNELDUMP_KEY_MAX_SIZE         64
   70 #define KERNELDUMP_ENCKEY_MAX_SIZE      (16384 / 8)
   71 
   72 /*
   73  * All uintX_t fields are in dump byte order, which is the same as
   74  * network byte order. Use the macros defined above to read or
   75  * write the fields.
   76  */
   77 struct kerneldumpheader {
   78         char            magic[20];
   79 #define KERNELDUMPMAGIC         "FreeBSD Kernel Dump"
   80 #define TEXTDUMPMAGIC           "FreeBSD Text Dump"
   81 #define KERNELDUMPMAGIC_CLEARED "Cleared Kernel Dump"
   82         char            architecture[12];
   83         uint32_t        version;
   84 #define KERNELDUMPVERSION               4
   85 #define KERNELDUMP_TEXT_VERSION         4
   86         uint32_t        architectureversion;
   87 #define KERNELDUMP_AARCH64_VERSION      1
   88 #define KERNELDUMP_AMD64_VERSION        2
   89 #define KERNELDUMP_ARM_VERSION          1
   90 #define KERNELDUMP_I386_VERSION         2
   91 #define KERNELDUMP_MIPS_VERSION         1
   92 #define KERNELDUMP_POWERPC_VERSION      1
   93 #define KERNELDUMP_RISCV_VERSION        1
   94 #define KERNELDUMP_SPARC64_VERSION      1
   95         uint64_t        dumplength;             /* excl headers */
   96         uint64_t        dumptime;
   97         uint32_t        dumpkeysize;
   98         uint32_t        blocksize;
   99         char            hostname[64];
  100         char            versionstring[192];
  101         char            panicstring[175];
  102         uint8_t         compression;
  103         uint64_t        dumpextent;
  104         char            unused[4];
  105         uint32_t        parity;
  106 };
  107 
  108 struct kerneldumpkey {
  109         uint8_t         kdk_encryption;
  110         uint8_t         kdk_iv[KERNELDUMP_IV_MAX_SIZE];
  111         uint32_t        kdk_encryptedkeysize;
  112         uint8_t         kdk_encryptedkey[];
  113 } __packed;
  114 
  115 /*
  116  * Parity calculation is endian insensitive.
  117  */
  118 static __inline u_int32_t
  119 kerneldump_parity(struct kerneldumpheader *kdhp)
  120 {
  121         uint32_t *up, parity;
  122         u_int i;
  123 
  124         up = (uint32_t *)kdhp;
  125         parity = 0;
  126         for (i = 0; i < sizeof *kdhp; i += sizeof *up)
  127                 parity ^= *up++;
  128         return (parity);
  129 }
  130 
  131 #ifdef _KERNEL
  132 struct dump_pa {
  133         vm_paddr_t pa_start;
  134         vm_paddr_t pa_size;
  135 };
  136 
  137 int dumpsys_generic(struct dumperinfo *);
  138 
  139 void dumpsys_map_chunk(vm_paddr_t, size_t, void **);
  140 typedef int dumpsys_callback_t(struct dump_pa *, int, void *);
  141 int dumpsys_foreach_chunk(dumpsys_callback_t, void *);
  142 int dumpsys_cb_dumpdata(struct dump_pa *, int, void *);
  143 int dumpsys_buf_seek(struct dumperinfo *, size_t);
  144 int dumpsys_buf_write(struct dumperinfo *, char *, size_t);
  145 int dumpsys_buf_flush(struct dumperinfo *);
  146 
  147 void dumpsys_gen_pa_init(void);
  148 struct dump_pa *dumpsys_gen_pa_next(struct dump_pa *);
  149 void dumpsys_gen_wbinv_all(void);
  150 void dumpsys_gen_unmap_chunk(vm_paddr_t, size_t, void *);
  151 int dumpsys_gen_write_aux_headers(struct dumperinfo *);
  152 
  153 extern int do_minidump;
  154 
  155 #endif
  156 
  157 #endif /* _SYS_KERNELDUMP_H */

Cache object: 68fd82dd3a9bfce796e7efa6bd56efee


[ source navigation ] [ diff markup ] [ identifier search ] [ freetext search ] [ file search ] [ list types ] [ track identifier ]


This page is part of the FreeBSD/Linux Linux Kernel Cross-Reference, and was automatically generated using a modified version of the LXR engine.