libprocstat.h revision 250223
1/*- 2 * Copyright (c) 2009 Stanislav Sedov <stas@FreeBSD.org> 3 * All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 14 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 15 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 16 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 17 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 18 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 19 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 20 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 21 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 22 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 23 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 24 * SUCH DAMAGE. 25 * 26 * $FreeBSD: head/lib/libprocstat/libprocstat.h 250223 2013-05-03 21:11:57Z jhb $ 27 */ 28 29#ifndef _LIBPROCSTAT_H_ 30#define _LIBPROCSTAT_H_ 31 32/* 33 * XXX: sys/elf.h conflicts with zfs_context.h. Workaround this by not 34 * including conflicting parts when building zfs code. 35 */ 36#ifndef ZFS 37#include <sys/elf.h> 38#endif 39 40/* 41 * Vnode types. 42 */ 43#define PS_FST_VTYPE_VNON 1 44#define PS_FST_VTYPE_VREG 2 45#define PS_FST_VTYPE_VDIR 3 46#define PS_FST_VTYPE_VBLK 4 47#define PS_FST_VTYPE_VCHR 5 48#define PS_FST_VTYPE_VLNK 6 49#define PS_FST_VTYPE_VSOCK 7 50#define PS_FST_VTYPE_VFIFO 8 51#define PS_FST_VTYPE_VBAD 9 52#define PS_FST_VTYPE_UNKNOWN 255 53 54/* 55 * Descriptor types. 56 */ 57#define PS_FST_TYPE_VNODE 1 58#define PS_FST_TYPE_FIFO 2 59#define PS_FST_TYPE_SOCKET 3 60#define PS_FST_TYPE_PIPE 4 61#define PS_FST_TYPE_PTS 5 62#define PS_FST_TYPE_KQUEUE 6 63#define PS_FST_TYPE_CRYPTO 7 64#define PS_FST_TYPE_MQUEUE 8 65#define PS_FST_TYPE_SHM 9 66#define PS_FST_TYPE_SEM 10 67#define PS_FST_TYPE_UNKNOWN 11 68#define PS_FST_TYPE_NONE 12 69 70/* 71 * Special descriptor numbers. 72 */ 73#define PS_FST_UFLAG_RDIR 0x0001 74#define PS_FST_UFLAG_CDIR 0x0002 75#define PS_FST_UFLAG_JAIL 0x0004 76#define PS_FST_UFLAG_TRACE 0x0008 77#define PS_FST_UFLAG_TEXT 0x0010 78#define PS_FST_UFLAG_MMAP 0x0020 79#define PS_FST_UFLAG_CTTY 0x0040 80 81/* 82 * Descriptor flags. 83 */ 84#define PS_FST_FFLAG_READ 0x0001 85#define PS_FST_FFLAG_WRITE 0x0002 86#define PS_FST_FFLAG_NONBLOCK 0x0004 87#define PS_FST_FFLAG_APPEND 0x0008 88#define PS_FST_FFLAG_SHLOCK 0x0010 89#define PS_FST_FFLAG_EXLOCK 0x0020 90#define PS_FST_FFLAG_ASYNC 0x0040 91#define PS_FST_FFLAG_SYNC 0x0080 92#define PS_FST_FFLAG_NOFOLLOW 0x0100 93#define PS_FST_FFLAG_CREAT 0x0200 94#define PS_FST_FFLAG_TRUNC 0x0400 95#define PS_FST_FFLAG_EXCL 0x0800 96#define PS_FST_FFLAG_DIRECT 0x1000 97#define PS_FST_FFLAG_EXEC 0x2000 98#define PS_FST_FFLAG_HASLOCK 0x4000 99 100struct kinfo_kstack; 101struct kinfo_vmentry; 102struct procstat; 103struct rlimit; 104struct filestat { 105 int fs_type; /* Descriptor type. */ 106 int fs_flags; /* filestat specific flags. */ 107 int fs_fflags; /* Descriptor access flags. */ 108 int fs_uflags; /* How this file is used. */ 109 int fs_fd; /* File descriptor number. */ 110 int fs_ref_count; /* Reference count. */ 111 off_t fs_offset; /* Seek location. */ 112 void *fs_typedep; /* Type dependent data. */ 113 char *fs_path; 114 STAILQ_ENTRY(filestat) next; 115 cap_rights_t fs_cap_rights; /* Capability rights, if flag set. */ 116}; 117struct vnstat { 118 uint64_t vn_fileid; 119 uint64_t vn_size; 120 char *vn_mntdir; 121 uint32_t vn_dev; 122 uint32_t vn_fsid; 123 int vn_type; 124 uint16_t vn_mode; 125 char vn_devname[SPECNAMELEN + 1]; 126}; 127struct ptsstat { 128 uint32_t dev; 129 char devname[SPECNAMELEN + 1]; 130}; 131struct pipestat { 132 size_t buffer_cnt; 133 uint64_t addr; 134 uint64_t peer; 135}; 136struct semstat { 137 uint32_t value; 138 uint16_t mode; 139}; 140struct shmstat { 141 uint64_t size; 142 uint16_t mode; 143}; 144struct sockstat { 145 uint64_t inp_ppcb; 146 uint64_t so_addr; 147 uint64_t so_pcb; 148 uint64_t unp_conn; 149 int dom_family; 150 int proto; 151 int so_rcv_sb_state; 152 int so_snd_sb_state; 153 struct sockaddr_storage sa_local; /* Socket address. */ 154 struct sockaddr_storage sa_peer; /* Peer address. */ 155 int type; 156 char dname[32]; 157}; 158 159STAILQ_HEAD(filestat_list, filestat); 160 161__BEGIN_DECLS 162void procstat_close(struct procstat *procstat); 163void procstat_freeargv(struct procstat *procstat); 164#ifndef ZFS 165void procstat_freeauxv(struct procstat *procstat, Elf_Auxinfo *auxv); 166#endif 167void procstat_freeenvv(struct procstat *procstat); 168void procstat_freegroups(struct procstat *procstat, gid_t *groups); 169void procstat_freekstack(struct procstat *procstat, 170 struct kinfo_kstack *kkstp); 171void procstat_freeprocs(struct procstat *procstat, struct kinfo_proc *p); 172void procstat_freefiles(struct procstat *procstat, 173 struct filestat_list *head); 174void procstat_freevmmap(struct procstat *procstat, 175 struct kinfo_vmentry *vmmap); 176struct filestat_list *procstat_getfiles(struct procstat *procstat, 177 struct kinfo_proc *kp, int mmapped); 178struct kinfo_proc *procstat_getprocs(struct procstat *procstat, 179 int what, int arg, unsigned int *count); 180int procstat_get_pipe_info(struct procstat *procstat, struct filestat *fst, 181 struct pipestat *pipe, char *errbuf); 182int procstat_get_pts_info(struct procstat *procstat, struct filestat *fst, 183 struct ptsstat *pts, char *errbuf); 184int procstat_get_sem_info(struct procstat *procstat, struct filestat *fst, 185 struct semstat *sem, char *errbuf); 186int procstat_get_shm_info(struct procstat *procstat, struct filestat *fst, 187 struct shmstat *shm, char *errbuf); 188int procstat_get_socket_info(struct procstat *procstat, struct filestat *fst, 189 struct sockstat *sock, char *errbuf); 190int procstat_get_vnode_info(struct procstat *procstat, struct filestat *fst, 191 struct vnstat *vn, char *errbuf); 192char **procstat_getargv(struct procstat *procstat, struct kinfo_proc *p, 193 size_t nchr); 194#ifndef ZFS 195Elf_Auxinfo *procstat_getauxv(struct procstat *procstat, 196 struct kinfo_proc *kp, unsigned int *cntp); 197#endif 198char **procstat_getenvv(struct procstat *procstat, struct kinfo_proc *p, 199 size_t nchr); 200gid_t *procstat_getgroups(struct procstat *procstat, struct kinfo_proc *kp, 201 unsigned int *count); 202struct kinfo_kstack *procstat_getkstack(struct procstat *procstat, 203 struct kinfo_proc *kp, unsigned int *count); 204int procstat_getosrel(struct procstat *procstat, struct kinfo_proc *kp, 205 int *osrelp); 206int procstat_getpathname(struct procstat *procstat, struct kinfo_proc *kp, 207 char *pathname, size_t maxlen); 208int procstat_getrlimit(struct procstat *procstat, struct kinfo_proc *kp, 209 int which, struct rlimit* rlimit); 210int procstat_getumask(struct procstat *procstat, struct kinfo_proc *kp, 211 unsigned short* umask); 212struct kinfo_vmentry *procstat_getvmmap(struct procstat *procstat, 213 struct kinfo_proc *kp, unsigned int *count); 214struct procstat *procstat_open_core(const char *filename); 215struct procstat *procstat_open_sysctl(void); 216struct procstat *procstat_open_kvm(const char *nlistf, const char *memf); 217__END_DECLS 218 219#endif /* !_LIBPROCSTAT_H_ */ 220