xref: /freebsd/lib/libkvm/kvm_private.h (revision 49b49cda41feabe3439f7318e8bf40e3896c7bf4)
1 /*-
2  * Copyright (c) 1992, 1993
3  *	The Regents of the University of California.  All rights reserved.
4  *
5  * This code is derived from software developed by the Computer Systems
6  * Engineering group at Lawrence Berkeley Laboratory under DARPA contract
7  * BG 91-66 and contributed to Berkeley.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  * 4. Neither the name of the University nor the names of its contributors
18  *    may be used to endorse or promote products derived from this software
19  *    without specific prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31  * SUCH DAMAGE.
32  *
33  *	@(#)kvm_private.h	8.1 (Berkeley) 6/4/93
34  * $FreeBSD$
35  */
36 
37 #include <sys/endian.h>
38 #include <sys/linker_set.h>
39 #include <gelf.h>
40 
41 struct kvm_arch {
42 	int	(*ka_probe)(kvm_t *);
43 	int	(*ka_initvtop)(kvm_t *);
44 	void	(*ka_freevtop)(kvm_t *);
45 	int	(*ka_kvatop)(kvm_t *, kvaddr_t, off_t *);
46 	int	(*ka_native)(kvm_t *);
47 };
48 
49 #define	KVM_ARCH(ka)	DATA_SET(kvm_arch, ka)
50 
51 struct __kvm {
52 	struct kvm_arch *arch;
53 	/*
54 	 * a string to be prepended to error messages
55 	 * provided for compatibility with sun's interface
56 	 * if this value is null, errors are saved in errbuf[]
57 	 */
58 	const char *program;
59 	char	*errp;		/* XXX this can probably go away */
60 	char	errbuf[_POSIX2_LINE_MAX];
61 #define ISALIVE(kd) ((kd)->vmfd >= 0)
62 	int	pmfd;		/* physical memory file (or crashdump) */
63 	int	vmfd;		/* virtual memory file (-1 if crashdump) */
64 	int	nlfd;		/* namelist file (e.g., /kernel) */
65 	GElf_Ehdr nlehdr;	/* ELF file header for namelist file */
66 	int	(*resolve_symbol)(const char *, kvaddr_t *);
67 	struct kinfo_proc *procbase;
68 	char	*argspc;	/* (dynamic) storage for argv strings */
69 	int	arglen;		/* length of the above */
70 	char	**argv;		/* (dynamic) storage for argv pointers */
71 	int	argc;		/* length of above (not actual # present) */
72 	char	*argbuf;	/* (dynamic) temporary storage */
73 	/*
74 	 * Kernel virtual address translation state.  This only gets filled
75 	 * in for dead kernels; otherwise, the running kernel (i.e. kmem)
76 	 * will do the translations for us.  It could be big, so we
77 	 * only allocate it if necessary.
78 	 */
79 	struct vmstate *vmst;
80 	int	rawdump;	/* raw dump format */
81 
82 	int		vnet_initialized;	/* vnet fields set up */
83 	kvaddr_t	vnet_start;	/* start of kernel's vnet region */
84 	kvaddr_t	vnet_stop;	/* stop of kernel's vnet region */
85 	kvaddr_t	vnet_current;	/* vnet we're working with */
86 	kvaddr_t	vnet_base;	/* vnet base of current vnet */
87 
88 	/*
89 	 * Dynamic per-CPU kernel memory.  We translate symbols, on-demand,
90 	 * to the data associated with dpcpu_curcpu, set with
91 	 * kvm_dpcpu_setcpu().
92 	 */
93 	int		dpcpu_initialized;	/* dpcpu fields set up */
94 	kvaddr_t	dpcpu_start;	/* start of kernel's dpcpu region */
95 	kvaddr_t	dpcpu_stop;	/* stop of kernel's dpcpu region */
96 	u_int		dpcpu_maxcpus;	/* size of base array */
97 	uintptr_t	*dpcpu_off;	/* base array, indexed by CPU ID */
98 	u_int		dpcpu_curcpu;	/* CPU we're currently working with */
99 	kvaddr_t	dpcpu_curoff;	/* dpcpu base of current CPU */
100 };
101 
102 /*
103  * Page table hash used by minidump backends to map physical addresses
104  * to file offsets.
105  */
106 struct hpte {
107 	struct hpte	*next;
108 	uint64_t	pa;
109 	off_t		off;
110 };
111 
112 #define HPT_SIZE 1024
113 
114 struct hpt {
115 	struct hpte	*hpt_head[HPT_SIZE];
116 };
117 
118 /*
119  * Functions used internally by kvm, but across kvm modules.
120  */
121 static inline uint32_t
122 _kvm32toh(kvm_t *kd, uint32_t val)
123 {
124 
125 	if (kd->nlehdr.e_ident[EI_DATA] == ELFDATA2LSB)
126 		return (le32toh(val));
127 	else
128 		return (be32toh(val));
129 }
130 
131 static inline uint64_t
132 _kvm64toh(kvm_t *kd, uint64_t val)
133 {
134 
135 	if (kd->nlehdr.e_ident[EI_DATA] == ELFDATA2LSB)
136 		return (le64toh(val));
137 	else
138 		return (be64toh(val));
139 }
140 
141 void	 _kvm_err(kvm_t *kd, const char *program, const char *fmt, ...)
142 	    __printflike(3, 4);
143 void	 _kvm_freeprocs(kvm_t *kd);
144 void	*_kvm_malloc(kvm_t *kd, size_t);
145 int	 _kvm_nlist(kvm_t *, struct kvm_nlist *, int);
146 void	*_kvm_realloc(kvm_t *kd, void *, size_t);
147 void	 _kvm_syserr (kvm_t *kd, const char *program, const char *fmt, ...)
148 	    __printflike(3, 4);
149 int	 _kvm_vnet_selectpid(kvm_t *, pid_t);
150 int	 _kvm_vnet_initialized(kvm_t *, int);
151 kvaddr_t _kvm_vnet_validaddr(kvm_t *, kvaddr_t);
152 int	 _kvm_dpcpu_initialized(kvm_t *, int);
153 kvaddr_t _kvm_dpcpu_validaddr(kvm_t *, kvaddr_t);
154 int	 _kvm_probe_elf_kernel(kvm_t *, int, int);
155 int	 _kvm_is_minidump(kvm_t *);
156 int	 _kvm_read_core_phdrs(kvm_t *, size_t *, GElf_Phdr **);
157 void	 _kvm_hpt_init(kvm_t *, struct hpt *, void *, size_t, off_t, int, int);
158 off_t	 _kvm_hpt_find(struct hpt *, uint64_t);
159 void	 _kvm_hpt_free(struct hpt *);
160