xref: /freebsd/lib/libprocstat/libprocstat.h (revision 884a2a699669ec61e2366e3e358342dbc94be24a)
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$
27  */
28 
29 #ifndef _LIBPROCSTAT_H_
30 #define	_LIBPROCSTAT_H_
31 
32 /*
33  * Vnode types.
34  */
35 #define	PS_FST_VTYPE_VNON	1
36 #define	PS_FST_VTYPE_VREG	2
37 #define	PS_FST_VTYPE_VDIR	3
38 #define	PS_FST_VTYPE_VBLK	4
39 #define	PS_FST_VTYPE_VCHR	5
40 #define	PS_FST_VTYPE_VLNK	6
41 #define	PS_FST_VTYPE_VSOCK	7
42 #define	PS_FST_VTYPE_VFIFO	8
43 #define	PS_FST_VTYPE_VBAD	9
44 #define	PS_FST_VTYPE_UNKNOWN	255
45 
46 /*
47  * Descriptor types.
48  */
49 #define	PS_FST_TYPE_VNODE	1
50 #define	PS_FST_TYPE_FIFO	2
51 #define	PS_FST_TYPE_SOCKET	3
52 #define	PS_FST_TYPE_PIPE	4
53 #define	PS_FST_TYPE_PTS		5
54 #define	PS_FST_TYPE_KQUEUE	6
55 #define	PS_FST_TYPE_CRYPTO	7
56 #define	PS_FST_TYPE_MQUEUE	8
57 #define	PS_FST_TYPE_SHM		9
58 #define	PS_FST_TYPE_SEM		10
59 #define	PS_FST_TYPE_UNKNOWN	11
60 #define	PS_FST_TYPE_NONE	12
61 
62 /*
63  * Special descriptor numbers.
64  */
65 #define	PS_FST_UFLAG_RDIR	0x0001
66 #define	PS_FST_UFLAG_CDIR	0x0002
67 #define	PS_FST_UFLAG_JAIL	0x0004
68 #define	PS_FST_UFLAG_TRACE	0x0008
69 #define	PS_FST_UFLAG_TEXT	0x0010
70 #define	PS_FST_UFLAG_MMAP	0x0020
71 #define	PS_FST_UFLAG_CTTY	0x0040
72 
73 /*
74  * Descriptor flags.
75  */
76 #define PS_FST_FFLAG_READ	0x0001
77 #define PS_FST_FFLAG_WRITE	0x0002
78 #define	PS_FST_FFLAG_NONBLOCK	0x0004
79 #define	PS_FST_FFLAG_APPEND	0x0008
80 #define	PS_FST_FFLAG_SHLOCK	0x0010
81 #define	PS_FST_FFLAG_EXLOCK	0x0020
82 #define	PS_FST_FFLAG_ASYNC	0x0040
83 #define	PS_FST_FFLAG_SYNC	0x0080
84 #define	PS_FST_FFLAG_NOFOLLOW	0x0100
85 #define	PS_FST_FFLAG_CREAT	0x0200
86 #define	PS_FST_FFLAG_TRUNC	0x0400
87 #define	PS_FST_FFLAG_EXCL	0x0800
88 #define	PS_FST_FFLAG_DIRECT	0x1000
89 #define	PS_FST_FFLAG_EXEC	0x2000
90 #define	PS_FST_FFLAG_HASLOCK	0x4000
91 
92 struct procstat;
93 struct filestat {
94 	int	fs_type;	/* Descriptor type. */
95 	int	fs_flags;	/* filestat specific flags. */
96 	int	fs_fflags;	/* Descriptor access flags. */
97 	int	fs_uflags;	/* How this file is used. */
98 	int	fs_fd;		/* File descriptor number. */
99 	int	fs_ref_count;	/* Reference count. */
100 	off_t	fs_offset;	/* Seek location. */
101 	void	*fs_typedep;	/* Type dependent data. */
102 	char	*fs_path;
103 	STAILQ_ENTRY(filestat)	next;
104 };
105 struct vnstat {
106 	uint64_t	vn_fileid;
107 	uint64_t	vn_size;
108 	char		*vn_mntdir;
109 	uint32_t	vn_dev;
110 	uint32_t	vn_fsid;
111 	int		vn_type;
112 	uint16_t	vn_mode;
113 	char		vn_devname[SPECNAMELEN + 1];
114 };
115 struct ptsstat {
116 	uint32_t	dev;
117 	char		devname[SPECNAMELEN + 1];
118 };
119 struct pipestat {
120 	size_t		buffer_cnt;
121 	uint64_t	addr;
122 	uint64_t	peer;
123 };
124 struct sockstat {
125 	uint64_t	inp_ppcb;
126 	uint64_t	so_addr;
127 	uint64_t	so_pcb;
128 	uint64_t	unp_conn;
129 	int		dom_family;
130 	int		proto;
131 	int		so_rcv_sb_state;
132 	int		so_snd_sb_state;
133 	struct sockaddr_storage	sa_local;	/* Socket address. */
134 	struct sockaddr_storage	sa_peer;	/* Peer address. */
135 	int		type;
136 	char		dname[32];
137 };
138 
139 STAILQ_HEAD(filestat_list, filestat);
140 
141 void	procstat_close(struct procstat *procstat);
142 void	procstat_freeprocs(struct procstat *procstat, struct kinfo_proc *p);
143 void	procstat_freefiles(struct procstat *procstat,
144     struct filestat_list *head);
145 struct filestat_list	*procstat_getfiles(struct procstat *procstat,
146     struct kinfo_proc *kp, int mmapped);
147 struct kinfo_proc	*procstat_getprocs(struct procstat *procstat,
148     int what, int arg, unsigned int *count);
149 int	procstat_get_pipe_info(struct procstat *procstat, struct filestat *fst,
150     struct pipestat *pipe, char *errbuf);
151 int	procstat_get_pts_info(struct procstat *procstat, struct filestat *fst,
152     struct ptsstat *pts, char *errbuf);
153 int	procstat_get_socket_info(struct procstat *procstat, struct filestat *fst,
154     struct sockstat *sock, char *errbuf);
155 int	procstat_get_vnode_info(struct procstat *procstat, struct filestat *fst,
156     struct vnstat *vn, char *errbuf);
157 struct procstat	*procstat_open_sysctl(void);
158 struct procstat	*procstat_open_kvm(const char *nlistf, const char *memf);
159 
160 #endif	/* !_LIBPROCSTAT_H_ */
161