f280594937
directory, and jail directory within procstat. While this functionality is available already in fstat, encapsulating it in the kern.proc.filedesc sysctl makes it accessible without using kvm and thus without needing elevated permissions. The new procstat output looks like: PID COMM FD T V FLAGS REF OFFSET PRO NAME 76792 tcsh cwd v d -------- - - - /usr/src 76792 tcsh root v d -------- - - - / 76792 tcsh 15 v c rw------ 16 9130 - - 76792 tcsh 16 v c rw------ 16 9130 - - 76792 tcsh 17 v c rw------ 16 9130 - - 76792 tcsh 18 v c rw------ 16 9130 - - 76792 tcsh 19 v c rw------ 16 9130 - - I am also bumping __FreeBSD_version for this as this new feature will be used in at least one port. Reviewed by: rwatson Approved by: rwatson
347 lines
13 KiB
C
347 lines
13 KiB
C
/*-
|
|
* Copyright (c) 1982, 1986, 1989, 1991, 1993
|
|
* The Regents of the University of California.
|
|
* Copyright (c) 2007 Robert N. M. Watson
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 4. Neither the name of the University nor the names of its contributors
|
|
* may be used to endorse or promote products derived from this software
|
|
* without specific prior written permission.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*
|
|
* @(#)user.h 8.2 (Berkeley) 9/23/93
|
|
* $FreeBSD$
|
|
*/
|
|
|
|
#ifndef _SYS_USER_H_
|
|
#define _SYS_USER_H_
|
|
|
|
#include <machine/pcb.h>
|
|
#ifndef _KERNEL
|
|
/* stuff that *used* to be included by user.h, or is now needed */
|
|
#include <sys/errno.h>
|
|
#include <sys/time.h>
|
|
#include <sys/resource.h>
|
|
#include <sys/ucred.h>
|
|
#include <sys/uio.h>
|
|
#include <sys/queue.h>
|
|
#include <sys/_lock.h>
|
|
#include <sys/_mutex.h>
|
|
#include <sys/proc.h>
|
|
#include <vm/vm.h> /* XXX */
|
|
#include <vm/vm_param.h> /* XXX */
|
|
#include <vm/pmap.h> /* XXX */
|
|
#include <vm/vm_map.h> /* XXX */
|
|
#endif /* !_KERNEL */
|
|
#ifndef _SYS_RESOURCEVAR_H_
|
|
#include <sys/resourcevar.h>
|
|
#endif
|
|
#ifndef _SYS_SIGNALVAR_H_
|
|
#include <sys/signalvar.h>
|
|
#endif
|
|
#ifndef _SYS_SOCKET_VAR_H_
|
|
#include <sys/socket.h>
|
|
#endif
|
|
|
|
/*
|
|
* KERN_PROC subtype ops return arrays of selected proc structure entries:
|
|
*
|
|
* This struct includes several arrays of spare space, with different arrays
|
|
* for different standard C-types. When adding new variables to this struct,
|
|
* the space for byte-aligned data should be taken from the ki_sparestring,
|
|
* pointers from ki_spareptrs, word-aligned data from ki_spareints, and
|
|
* doubleword-aligned data from ki_sparelongs. Make sure the space for new
|
|
* variables come from the array which matches the size and alignment of
|
|
* those variables on ALL hardware platforms, and then adjust the appropriate
|
|
* KI_NSPARE_* value(s) to match.
|
|
*
|
|
* Always verify that sizeof(struct kinfo_proc) == KINFO_PROC_SIZE on all
|
|
* platforms after you have added new variables. Note that if you change
|
|
* the value of KINFO_PROC_SIZE, then many userland programs will stop
|
|
* working until they are recompiled!
|
|
*
|
|
* Once you have added the new field, you will need to add code to initialize
|
|
* it in two places: function fill_kinfo_proc in sys/kern/kern_proc.c and
|
|
* function kvm_proclist in lib/libkvm/kvm_proc.c .
|
|
*/
|
|
#define KI_NSPARE_INT 10
|
|
#define KI_NSPARE_LONG 12
|
|
#define KI_NSPARE_PTR 7
|
|
|
|
#ifdef __amd64__
|
|
#define KINFO_PROC_SIZE 1088
|
|
#endif
|
|
#ifdef __arm__
|
|
#define KINFO_PROC_SIZE 792
|
|
#endif
|
|
#ifdef __ia64__
|
|
#define KINFO_PROC_SIZE 1088
|
|
#endif
|
|
#ifdef __i386__
|
|
#define KINFO_PROC_SIZE 768
|
|
#endif
|
|
#ifdef __powerpc__
|
|
#define KINFO_PROC_SIZE 768
|
|
#endif
|
|
#ifdef __sparc64__
|
|
#define KINFO_PROC_SIZE 1088
|
|
#endif
|
|
#ifndef KINFO_PROC_SIZE
|
|
#error "Unknown architecture"
|
|
#endif
|
|
|
|
#define WMESGLEN 8 /* size of returned wchan message */
|
|
#define LOCKNAMELEN 8 /* size of returned lock name */
|
|
#define OCOMMLEN 16 /* size of returned thread name */
|
|
#define COMMLEN 19 /* size of returned ki_comm name */
|
|
#define KI_EMULNAMELEN 16 /* size of returned ki_emul */
|
|
#define KI_NGROUPS 16 /* number of groups in ki_groups */
|
|
#define LOGNAMELEN 17 /* size of returned ki_login */
|
|
|
|
struct kinfo_proc {
|
|
int ki_structsize; /* size of this structure */
|
|
int ki_layout; /* reserved: layout identifier */
|
|
struct pargs *ki_args; /* address of command arguments */
|
|
struct proc *ki_paddr; /* address of proc */
|
|
struct user *ki_addr; /* kernel virtual addr of u-area */
|
|
struct vnode *ki_tracep; /* pointer to trace file */
|
|
struct vnode *ki_textvp; /* pointer to executable file */
|
|
struct filedesc *ki_fd; /* pointer to open file info */
|
|
struct vmspace *ki_vmspace; /* pointer to kernel vmspace struct */
|
|
void *ki_wchan; /* sleep address */
|
|
pid_t ki_pid; /* Process identifier */
|
|
pid_t ki_ppid; /* parent process id */
|
|
pid_t ki_pgid; /* process group id */
|
|
pid_t ki_tpgid; /* tty process group id */
|
|
pid_t ki_sid; /* Process session ID */
|
|
pid_t ki_tsid; /* Terminal session ID */
|
|
short ki_jobc; /* job control counter */
|
|
short ki_spare_short1; /* unused (just here for alignment) */
|
|
dev_t ki_tdev; /* controlling tty dev */
|
|
sigset_t ki_siglist; /* Signals arrived but not delivered */
|
|
sigset_t ki_sigmask; /* Current signal mask */
|
|
sigset_t ki_sigignore; /* Signals being ignored */
|
|
sigset_t ki_sigcatch; /* Signals being caught by user */
|
|
uid_t ki_uid; /* effective user id */
|
|
uid_t ki_ruid; /* Real user id */
|
|
uid_t ki_svuid; /* Saved effective user id */
|
|
gid_t ki_rgid; /* Real group id */
|
|
gid_t ki_svgid; /* Saved effective group id */
|
|
short ki_ngroups; /* number of groups */
|
|
short ki_spare_short2; /* unused (just here for alignment) */
|
|
gid_t ki_groups[KI_NGROUPS]; /* groups */
|
|
vm_size_t ki_size; /* virtual size */
|
|
segsz_t ki_rssize; /* current resident set size in pages */
|
|
segsz_t ki_swrss; /* resident set size before last swap */
|
|
segsz_t ki_tsize; /* text size (pages) XXX */
|
|
segsz_t ki_dsize; /* data size (pages) XXX */
|
|
segsz_t ki_ssize; /* stack size (pages) */
|
|
u_short ki_xstat; /* Exit status for wait & stop signal */
|
|
u_short ki_acflag; /* Accounting flags */
|
|
fixpt_t ki_pctcpu; /* %cpu for process during ki_swtime */
|
|
u_int ki_estcpu; /* Time averaged value of ki_cpticks */
|
|
u_int ki_slptime; /* Time since last blocked */
|
|
u_int ki_swtime; /* Time swapped in or out */
|
|
int ki_spareint1; /* unused (just here for alignment) */
|
|
u_int64_t ki_runtime; /* Real time in microsec */
|
|
struct timeval ki_start; /* starting time */
|
|
struct timeval ki_childtime; /* time used by process children */
|
|
long ki_flag; /* P_* flags */
|
|
long ki_kiflag; /* KI_* flags (below) */
|
|
int ki_traceflag; /* Kernel trace points */
|
|
char ki_stat; /* S* process status */
|
|
signed char ki_nice; /* Process "nice" value */
|
|
char ki_lock; /* Process lock (prevent swap) count */
|
|
char ki_rqindex; /* Run queue index */
|
|
u_char ki_oncpu; /* Which cpu we are on */
|
|
u_char ki_lastcpu; /* Last cpu we were on */
|
|
char ki_ocomm[OCOMMLEN+1]; /* thread name */
|
|
char ki_wmesg[WMESGLEN+1]; /* wchan message */
|
|
char ki_login[LOGNAMELEN+1]; /* setlogin name */
|
|
char ki_lockname[LOCKNAMELEN+1]; /* lock name */
|
|
char ki_comm[COMMLEN+1]; /* command name */
|
|
char ki_emul[KI_EMULNAMELEN+1]; /* emulation name */
|
|
/*
|
|
* When adding new variables, take space for char-strings from the
|
|
* front of ki_sparestrings, and ints from the end of ki_spareints.
|
|
* That way the spare room from both arrays will remain contiguous.
|
|
*/
|
|
char ki_sparestrings[68]; /* spare string space */
|
|
int ki_spareints[KI_NSPARE_INT]; /* spare room for growth */
|
|
int ki_jid; /* Process jail ID */
|
|
int ki_numthreads; /* XXXKSE number of threads in total */
|
|
lwpid_t ki_tid; /* XXXKSE thread id */
|
|
struct priority ki_pri; /* process priority */
|
|
struct rusage ki_rusage; /* process rusage statistics */
|
|
/* XXX - most fields in ki_rusage_ch are not (yet) filled in */
|
|
struct rusage ki_rusage_ch; /* rusage of children processes */
|
|
struct pcb *ki_pcb; /* kernel virtual addr of pcb */
|
|
void *ki_kstack; /* kernel virtual addr of stack */
|
|
void *ki_udata; /* User convenience pointer */
|
|
/*
|
|
* When adding new variables, take space for pointers from the
|
|
* front of ki_spareptrs, and longs from the end of ki_sparelongs.
|
|
* That way the spare room from both arrays will remain contiguous.
|
|
*/
|
|
void *ki_spareptrs[KI_NSPARE_PTR]; /* spare room for growth */
|
|
long ki_sparelongs[KI_NSPARE_LONG]; /* spare room for growth */
|
|
long ki_sflag; /* PS_* flags */
|
|
long ki_tdflags; /* XXXKSE kthread flag */
|
|
};
|
|
void fill_kinfo_proc(struct proc *, struct kinfo_proc *);
|
|
/* XXX - the following two defines are temporary */
|
|
#define ki_childstime ki_rusage_ch.ru_stime
|
|
#define ki_childutime ki_rusage_ch.ru_utime
|
|
|
|
/*
|
|
* Legacy PS_ flag. This moved to p_flag but is maintained for
|
|
* compatibility.
|
|
*/
|
|
#define PS_INMEM 0x00001 /* Loaded into memory. */
|
|
|
|
/* ki_sessflag values */
|
|
#define KI_CTTY 0x00000001 /* controlling tty vnode active */
|
|
#define KI_SLEADER 0x00000002 /* session leader */
|
|
#define KI_LOCKBLOCK 0x00000004 /* proc blocked on lock ki_lockname */
|
|
|
|
/*
|
|
* This used to be the per-process structure containing data that
|
|
* isn't needed in core when the process is swapped out, but now it
|
|
* remains only for the benefit of a.out core dumps.
|
|
*/
|
|
struct user {
|
|
struct pstats u_stats; /* *p_stats */
|
|
struct kinfo_proc u_kproc; /* eproc */
|
|
};
|
|
|
|
/*
|
|
* The KERN_PROC_FILE sysctl allows a process to dump the file descriptor
|
|
* array of another process.
|
|
*/
|
|
#define KF_TYPE_NONE 0
|
|
#define KF_TYPE_VNODE 1
|
|
#define KF_TYPE_SOCKET 2
|
|
#define KF_TYPE_PIPE 3
|
|
#define KF_TYPE_FIFO 4
|
|
#define KF_TYPE_KQUEUE 5
|
|
#define KF_TYPE_CRYPTO 6
|
|
#define KF_TYPE_MQUEUE 7
|
|
#define KF_TYPE_SHM 8
|
|
#define KF_TYPE_UNKNOWN 255
|
|
|
|
#define KF_VTYPE_VNON 0
|
|
#define KF_VTYPE_VREG 1
|
|
#define KF_VTYPE_VDIR 2
|
|
#define KF_VTYPE_VBLK 3
|
|
#define KF_VTYPE_VCHR 4
|
|
#define KF_VTYPE_VLNK 5
|
|
#define KF_VTYPE_VSOCK 6
|
|
#define KF_VTYPE_VFIFO 7
|
|
#define KF_VTYPE_VBAD 8
|
|
#define KF_VTYPE_UNKNOWN 255
|
|
|
|
#define KF_FD_TYPE_CWD -1 /* Current working directory */
|
|
#define KF_FD_TYPE_ROOT -2 /* Root directory */
|
|
#define KF_FD_TYPE_JAIL -3 /* Jail directory */
|
|
|
|
#define KF_FLAG_READ 0x00000001
|
|
#define KF_FLAG_WRITE 0x00000002
|
|
#define KF_FLAG_APPEND 0x00000004
|
|
#define KF_FLAG_ASYNC 0x00000008
|
|
#define KF_FLAG_FSYNC 0x00000010
|
|
#define KF_FLAG_NONBLOCK 0x00000020
|
|
#define KF_FLAG_DIRECT 0x00000040
|
|
#define KF_FLAG_HASLOCK 0x00000080
|
|
|
|
struct kinfo_file {
|
|
int kf_structsize; /* Size of kinfo_file. */
|
|
int kf_type; /* Descriptor type. */
|
|
int kf_fd; /* Array index. */
|
|
int kf_ref_count; /* Reference count. */
|
|
int kf_flags; /* Flags. */
|
|
off_t kf_offset; /* Seek location. */
|
|
int kf_vnode_type; /* Vnode type. */
|
|
int kf_sock_domain; /* Socket domain. */
|
|
int kf_sock_type; /* Socket type. */
|
|
int kf_sock_protocol; /* Socket protocol. */
|
|
char kf_path[PATH_MAX]; /* Path to file, if any. */
|
|
struct sockaddr_storage kf_sa_local; /* Socket address. */
|
|
struct sockaddr_storage kf_sa_peer; /* Peer address. */
|
|
};
|
|
|
|
/*
|
|
* The KERN_PROC_VMMAP sysctl allows a process to dump the VM layout of
|
|
* another process as a series of entries.
|
|
*/
|
|
#define KVME_TYPE_NONE 0
|
|
#define KVME_TYPE_DEFAULT 1
|
|
#define KVME_TYPE_VNODE 2
|
|
#define KVME_TYPE_SWAP 3
|
|
#define KVME_TYPE_DEVICE 4
|
|
#define KVME_TYPE_PHYS 5
|
|
#define KVME_TYPE_DEAD 6
|
|
#define KVME_TYPE_UNKNOWN 255
|
|
|
|
#define KVME_PROT_READ 0x00000001
|
|
#define KVME_PROT_WRITE 0x00000002
|
|
#define KVME_PROT_EXEC 0x00000004
|
|
|
|
#define KVME_FLAG_COW 0x00000001
|
|
#define KVME_FLAG_NEEDS_COPY 0x00000002
|
|
|
|
struct kinfo_vmentry {
|
|
int kve_structsize; /* Size of kinfo_vmmapentry. */
|
|
int kve_type; /* Type of map entry. */
|
|
void *kve_start; /* Starting pointer. */
|
|
void *kve_end; /* Finishing pointer. */
|
|
int kve_flags; /* Flags on map entry. */
|
|
int kve_resident; /* Number of resident pages. */
|
|
int kve_private_resident; /* Number of private pages. */
|
|
int kve_protection; /* Protection bitmask. */
|
|
int kve_ref_count; /* VM obj ref count. */
|
|
int kve_shadow_count; /* VM obj shadow count. */
|
|
char kve_path[PATH_MAX]; /* Path to VM obj, if any. */
|
|
void *_kve_pspare[8]; /* Space for more stuff. */
|
|
int _kve_ispare[8]; /* Space for more stuff. */
|
|
};
|
|
|
|
/*
|
|
* The KERN_PROC_KSTACK sysctl allows a process to dump the kernel stacks of
|
|
* another process as a series of entries. Each stack is represented by a
|
|
* series of symbol names and offsets as generated by stack_sbuf_print(9).
|
|
*/
|
|
#define KKST_MAXLEN 1024
|
|
|
|
#define KKST_STATE_STACKOK 0 /* Stack is valid. */
|
|
#define KKST_STATE_SWAPPED 1 /* Stack swapped out. */
|
|
#define KKST_STATE_RUNNING 2 /* Stack ephemeral. */
|
|
|
|
struct kinfo_kstack {
|
|
lwpid_t kkst_tid; /* ID of thread. */
|
|
int kkst_state; /* Validity of stack. */
|
|
char kkst_trace[KKST_MAXLEN]; /* String representing stack. */
|
|
void *_kkst_pspare[8]; /* Space for more stuff. */
|
|
int _kkst_ispare[8]; /* Space for more stuff. */
|
|
};
|
|
|
|
#endif
|