2 * Copyright (c) 2005 Apple Computer, Inc. All rights reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
29 #ifndef _SYS_PROC_INFO_H
30 #define _SYS_PROC_INFO_H
32 #include <sys/cdefs.h>
33 #include <sys/param.h>
34 #include <sys/types.h>
36 #include <sys/mount.h>
37 #include <sys/socket.h>
39 #include <sys/kern_control.h>
41 #include <net/route.h>
42 #include <netinet/in.h>
43 #include <netinet/tcp.h>
48 #define PROC_ALL_PIDS 1
49 #define PROC_PGRP_ONLY 2
50 #define PROC_TTY_ONLY 3
51 #define PROC_UID_ONLY 4
52 #define PROC_RUID_ONLY 5
55 uint32_t pbi_flags
; /* 64bit; emulated etc */
66 char pbi_comm
[MAXCOMLEN
+ 1];
67 char pbi_name
[2*MAXCOMLEN
+ 1]; /* empty if no name is registered */
71 uint32_t e_tdev
; /* controlling tty dev */
72 uint32_t e_tpgid
; /* tty process group id */
73 struct timeval pbi_start
;
79 /* pbi_flags values */
80 #define PROC_FLAG_SYSTEM 1
81 #define PROC_FLAG_TRACED 2
82 #define PROC_FLAG_INEXIT 4
83 #define PROC_FLAG_PPWAIT 8
84 #define PROC_FLAG_LP64 0x10
85 #define PROC_FLAG_SLEADER 0x20
86 #define PROC_FLAG_CTTY 0x40
87 #define PROC_FLAG_CONTROLT 0x80
88 #define PROC_FLAG_THCWD 0x100
91 struct proc_taskinfo
{
92 uint64_t pti_virtual_size
; /* virtual memory size (bytes) */
93 uint64_t pti_resident_size
; /* resident memory size (bytes) */
94 uint64_t pti_total_user
; /* total time */
95 uint64_t pti_total_system
;
96 uint64_t pti_threads_user
; /* existing threads only */
97 uint64_t pti_threads_system
;
98 int32_t pti_policy
; /* default policy for new threads */
99 int32_t pti_faults
; /* number of page faults */
100 int32_t pti_pageins
; /* number of actual pageins */
101 int32_t pti_cow_faults
; /* number of copy-on-write faults */
102 int32_t pti_messages_sent
; /* number of messages sent */
103 int32_t pti_messages_received
; /* number of messages received */
104 int32_t pti_syscalls_mach
; /* number of mach system calls */
105 int32_t pti_syscalls_unix
; /* number of unix system calls */
106 int32_t pti_csw
; /* number of context switches */
107 int32_t pti_threadnum
; /* number of threads in the task */
108 int32_t pti_numrunning
; /* number of running threads */
109 int32_t pti_priority
; /* task priority*/
112 struct proc_taskallinfo
{
113 struct proc_bsdinfo pbsd
;
114 struct proc_taskinfo ptinfo
;
118 struct proc_threadinfo
{
119 uint64_t pth_user_time
; /* user run time */
120 uint64_t pth_system_time
; /* system run time */
121 int32_t pth_cpu_usage
; /* scaled cpu usage percentage */
122 int32_t pth_policy
; /* scheduling policy in effect */
123 int32_t pth_run_state
; /* run state (see below) */
124 int32_t pth_flags
; /* various flags (see below) */
125 int32_t pth_sleep_time
; /* number of seconds that thread */
126 int32_t pth_curpri
; /* cur priority*/
127 int32_t pth_priority
; /* priority*/
128 int32_t pth_maxpriority
; /* max priority*/
129 char * pth_name
[64]; /* thread name, if any */
132 struct proc_regioninfo
{
133 uint32_t pri_protection
;
134 uint32_t pri_max_protection
;
135 uint32_t pri_inheritance
;
136 uint32_t pri_flags
; /* shared, external pager, is submap */
138 uint32_t pri_behavior
;
139 uint32_t pri_user_wired_count
;
140 uint32_t pri_user_tag
;
141 uint32_t pri_pages_resident
;
142 uint32_t pri_pages_shared_now_private
;
143 uint32_t pri_pages_swapped_out
;
144 uint32_t pri_pages_dirtied
;
145 uint32_t pri_ref_count
;
146 uint32_t pri_shadow_depth
;
147 uint32_t pri_share_mode
;
148 uint32_t pri_private_pages_resident
;
149 uint32_t pri_shared_pages_resident
;
152 uint64_t pri_address
;
156 #define PROC_REGION_SUBMAP 1
157 #define PROC_REGION_SHARED 2
163 #define SM_TRUESHARED 5
164 #define SM_PRIVATE_ALIASED 6
165 #define SM_SHARED_ALIASED 7
169 * Thread run states (state field).
172 #define TH_STATE_RUNNING 1 /* thread is running normally */
173 #define TH_STATE_STOPPED 2 /* thread is stopped */
174 #define TH_STATE_WAITING 3 /* thread is waiting normally */
175 #define TH_STATE_UNINTERRUPTIBLE 4 /* thread is in an uninterruptible
177 #define TH_STATE_HALTED 5 /* thread is halted at a
181 * Thread flags (flags field).
183 #define TH_FLAGS_SWAPPED 0x1 /* thread is swapped out */
184 #define TH_FLAGS_IDLE 0x2 /* thread is an idle thread */
188 struct proc_fileinfo
{
189 uint32_t fi_openflags
;
195 /* stats flags in proc_fileinfo */
196 #define PROC_FP_SHARED 1 /* shared by more than one fd */
197 #define PROC_FP_CLEXEC 2 /* close on exec */
200 * A copy of stat64 with static sized fields.
203 uint32_t vst_dev
; /* [XSI] ID of device containing file */
204 uint16_t vst_mode
; /* [XSI] Mode of file (see below) */
205 uint16_t vst_nlink
; /* [XSI] Number of hard links */
206 uint64_t vst_ino
; /* [XSI] File serial number */
207 uid_t vst_uid
; /* [XSI] User ID of the file */
208 gid_t vst_gid
; /* [XSI] Group ID of the file */
209 int64_t vst_atime
; /* [XSI] Time of last access */
210 int64_t vst_atimensec
; /* nsec of last access */
211 int64_t vst_mtime
; /* [XSI] Last data modification time */
212 int64_t vst_mtimensec
; /* last data modification nsec */
213 int64_t vst_ctime
; /* [XSI] Time of last status change */
214 int64_t vst_ctimensec
; /* nsec of last status change */
215 int64_t vst_birthtime
; /* File creation time(birth) */
216 int64_t vst_birthtimensec
; /* nsec of File creation time */
217 off_t vst_size
; /* [XSI] file size, in bytes */
218 int64_t vst_blocks
; /* [XSI] blocks allocated for file */
219 int32_t vst_blksize
; /* [XSI] optimal blocksize for I/O */
220 uint32_t vst_flags
; /* user defined flags for file */
221 uint32_t vst_gen
; /* file generation number */
222 uint32_t vst_rdev
; /* [XSI] Device ID */
223 int64_t vst_qspare
[2]; /* RESERVED: DO NOT USE! */
227 struct vinfo_stat vi_stat
;
233 struct vnode_info_path
{
234 struct vnode_info vip_vi
;
235 char vip_path
[MAXPATHLEN
]; /* tail end of it */
238 struct vnode_fdinfo
{
239 struct proc_fileinfo pfi
;
240 struct vnode_info pvi
;
243 struct vnode_fdinfowithpath
{
244 struct proc_fileinfo pfi
;
245 struct vnode_info_path pvip
;
248 struct proc_regionwithpathinfo
{
249 struct proc_regioninfo prp_prinfo
;
250 struct vnode_info_path prp_vip
;
253 struct proc_vnodepathinfo
{
254 struct vnode_info_path pvi_cdir
;
255 struct vnode_info_path pvi_rdir
;
258 struct proc_threadwithpathinfo
{
259 struct proc_threadinfo pt
;
260 struct vnode_info_path pvip
;
269 * IPv4 and IPv6 Sockets
276 u_int32_t i46a_pad32
[3];
277 struct in_addr i46a_addr4
;
281 int insi_fport
; /* foreign port */
282 int insi_lport
; /* local port */
283 uint64_t insi_gencnt
; /* generation count of this instance */
284 uint32_t insi_flags
; /* generic IP/datagram flags */
287 uint8_t insi_vflag
; /* ini_IPV4 or ini_IPV6 */
288 uint8_t insi_ip_ttl
; /* time to live proto */
289 /* protocol dependent part */
291 struct in4in6_addr ina_46
;
292 struct in6_addr ina_6
;
293 } insi_faddr
; /* foreign host table entry */
295 struct in4in6_addr ina_46
;
296 struct in6_addr ina_6
;
297 } insi_laddr
; /* local host table entry */
299 u_char in4_tos
; /* type of service */
313 #define TSI_T_REXMT 0 /* retransmit */
314 #define TSI_T_PERSIST 1 /* retransmit persistence */
315 #define TSI_T_KEEP 2 /* keep alive */
316 #define TSI_T_2MSL 3 /* 2*msl quiet time timer */
317 #define TSI_T_NTIMERS 4
319 #define TSI_S_CLOSED 0 /* closed */
320 #define TSI_S_LISTEN 1 /* listening for connection */
321 #define TSI_S_SYN_SENT 2 /* active, have sent syn */
322 #define TSI_S_SYN_RECEIVED 3 /* have send and received syn */
323 #define TSI_S_ESTABLISHED 4 /* established */
324 #define TSI_S__CLOSE_WAIT 5 /* rcvd fin, waiting for close */
325 #define TSI_S_FIN_WAIT_1 6 /* have closed, sent fin */
326 #define TSI_S_CLOSING 7 /* closed xchd FIN; await FIN ACK */
327 #define TSI_S_LAST_ACK 8 /* had fin and close; await FIN ACK */
328 #define TSI_S_FIN_WAIT_2 9 /* have closed, fin is acked */
329 #define TSI_S_TIME_WAIT 10 /* in 2*msl quiet wait after close */
330 #define TSI_S_RESERVED 11 /* pseudo state: reserved */
332 struct tcp_sockinfo
{
333 struct in_sockinfo tcpsi_ini
;
335 int tcpsi_timer
[TSI_T_NTIMERS
];
337 uint32_t tcpsi_flags
;
338 uint64_t tcpsi_tp
; /* opaque handle of TCP protocol control block */
342 * Unix Domain Sockets
347 uint64_t unsi_conn_so
; /* opaque handle of connected socket */
348 uint64_t unsi_conn_pcb
; /* opaque handle of connected protocol control block */
350 struct sockaddr_un ua_sun
;
351 char ua_dummy
[SOCK_MAXADDRLEN
];
352 } unsi_addr
; /* bound address */
354 struct sockaddr_un ua_sun
;
355 char ua_dummy
[SOCK_MAXADDRLEN
];
356 } unsi_caddr
; /* address of socket connected to */
364 uint32_t ndrvsi_if_family
;
365 uint32_t ndrvsi_if_unit
;
366 char ndrvsi_if_name
[IF_NAMESIZE
];
370 * Kernel Event Sockets
373 struct kern_event_info
{
374 uint32_t kesi_vendor_code_filter
;
375 uint32_t kesi_class_filter
;
376 uint32_t kesi_subclass_filter
;
380 * Kernel Control Sockets
383 struct kern_ctl_info
{
385 uint32_t kcsi_reg_unit
;
386 uint32_t kcsi_flags
; /* support flags */
387 uint32_t kcsi_recvbufsize
; /* request more than the default buffer size */
388 uint32_t kcsi_sendbufsize
; /* request more than the default buffer size */
390 char kcsi_name
[MAX_KCTL_NAME
]; /* unique nke identifier, provided by DTS */
395 #define SOI_S_NOFDREF 0x0001 /* no file table ref any more */
396 #define SOI_S_ISCONNECTED 0x0002 /* socket connected to a peer */
397 #define SOI_S_ISCONNECTING 0x0004 /* in process of connecting to peer */
398 #define SOI_S_ISDISCONNECTING 0x0008 /* in process of disconnecting */
399 #define SOI_S_CANTSENDMORE 0x0010 /* can't send more data to peer */
400 #define SOI_S_CANTRCVMORE 0x0020 /* can't receive more data from peer */
401 #define SOI_S_RCVATMARK 0x0040 /* at mark on input */
402 #define SOI_S_PRIV 0x0080 /* privileged for broadcast, raw... */
403 #define SOI_S_NBIO 0x0100 /* non-blocking ops */
404 #define SOI_S_ASYNC 0x0200 /* async i/o notify */
405 #define SOI_S_INCOMP 0x0800 /* Unaccepted, incomplete connection */
406 #define SOI_S_COMP 0x1000 /* unaccepted, complete connection */
407 #define SOI_S_ISDISCONNECTED 0x2000 /* socket disconnected from peer */
408 #define SOI_S_DRAINING 0x4000 /* close waiting for blocked system calls to drain */
410 struct sockbuf_info
{
412 uint32_t sbi_hiwat
; /* SO_RCVBUF, SO_SNDBUF */
421 SOCKINFO_GENERIC
= 0,
426 SOCKINFO_KERN_EVENT
= 5,
427 SOCKINFO_KERN_CTL
= 6
431 struct stat soi_stat
;
432 uint64_t soi_so
; /* opaque handle of socket */
433 uint64_t soi_pcb
; /* opaque handle of protocol control block */
445 uint32_t soi_oobmark
;
446 struct sockbuf_info soi_rcv
;
447 struct sockbuf_info soi_snd
;
450 struct in_sockinfo pri_in
; /* SOCKINFO_IN */
451 struct tcp_sockinfo pri_tcp
; /* SOCKINFO_TCP */
452 struct un_sockinfo pri_un
; /* SOCKINFO_UN */
453 struct ndrv_info pri_ndrv
; /* SOCKINFO_NDRV */
454 struct kern_event_info pri_kern_event
; /* SOCKINFO_KERN_EVENT */
455 struct kern_ctl_info pri_kern_ctl
; /* SOCKINFO_KERN_CTL */
459 struct socket_fdinfo
{
460 struct proc_fileinfo pfi
;
461 struct socket_info psi
;
467 struct vinfo_stat psem_stat
;
468 char psem_name
[MAXPATHLEN
];
472 struct proc_fileinfo pfi
;
473 struct psem_info pseminfo
;
479 struct vinfo_stat pshm_stat
;
480 uint64_t pshm_mappaddr
;
481 char pshm_name
[MAXPATHLEN
];
485 struct proc_fileinfo pfi
;
486 struct pshm_info pshminfo
;
491 struct vinfo_stat pipe_stat
;
492 uint64_t pipe_handle
;
493 uint64_t pipe_peerhandle
;
498 struct proc_fileinfo pfi
;
499 struct pipe_info pipeinfo
;
504 struct vinfo_stat kq_stat
;
507 #define PROC_KQUEUE_SELECT 1
508 #define PROC_KQUEUE_SLEEP 2
510 struct kqueue_fdinfo
{
511 struct proc_fileinfo pfi
;
512 struct kqueue_info kqueueinfo
;
515 struct appletalk_info
{
516 struct vinfo_stat atalk_stat
;
519 struct appletalk_fdinfo
{
520 struct proc_fileinfo pfi
;
521 struct appletalk_info appletalkinfo
;
526 /* defns of process file desc type */
527 #define PROX_FDTYPE_ATALK 0
528 #define PROX_FDTYPE_VNODE 1
529 #define PROX_FDTYPE_SOCKET 2
530 #define PROX_FDTYPE_PSHM 3
531 #define PROX_FDTYPE_PSEM 4
532 #define PROX_FDTYPE_KQUEUE 5
533 #define PROX_FDTYPE_PIPE 6
534 #define PROX_FDTYPE_FSEVENTS 7
538 uint32_t proc_fdtype
;
541 /* Falvors for proc_pidinfo() */
542 #define PROC_PIDLISTFDS 1
543 #define PROC_PIDLISTFD_SIZE (sizeof(struct proc_fdinfo))
545 #define PROC_PIDTASKALLINFO 2
546 #define PROC_PIDTASKALLINFO_SIZE (sizeof(struct proc_taskallinfo))
548 #define PROC_PIDTBSDINFO 3
549 #define PROC_PIDTBSDINFO_SIZE (sizeof(struct proc_bsdinfo))
551 #define PROC_PIDTASKINFO 4
552 #define PROC_PIDTASKINFO_SIZE (sizeof(struct proc_taskinfo))
554 #define PROC_PIDTHREADINFO 5
555 #define PROC_PIDTHREADINFO_SIZE (sizeof(struct proc_threadinfo))
557 #define PROC_PIDLISTTHREADS 6
558 #define PROC_PIDLISTTHREADS_SIZE (2* sizeof(uint32_t))
561 #define PROC_PIDREGIONINFO 7
562 #define PROC_PIDREGIONINFO_SIZE (sizeof(struct proc_regioninfo))
564 #define PROC_PIDREGIONPATHINFO 8
565 #define PROC_PIDREGIONPATHINFO_SIZE (sizeof(struct proc_regionwithpathinfo))
567 #define PROC_PIDVNODEPATHINFO 9
568 #define PROC_PIDVNODEPATHINFO_SIZE (sizeof(struct proc_vnodepathinfo))
570 #define PROC_PIDTHREADPATHINFO 10
571 #define PROC_PIDTHREADPATHINFO_SIZE (sizeof(struct proc_threadwithpathinfo))
573 #define PROC_PIDPATHINFO 11
574 #define PROC_PIDPATHINFO_SIZE (MAXPATHLEN)
575 #define PROC_PIDPATHINFO_MAXSIZE (4*MAXPATHLEN)
577 /* Flavors for proc_pidfdinfo */
579 #define PROC_PIDFDVNODEINFO 1
580 #define PROC_PIDFDVNODEINFO_SIZE (sizeof(struct vnode_fdinfo))
582 #define PROC_PIDFDVNODEPATHINFO 2
583 #define PROC_PIDFDVNODEPATHINFO_SIZE (sizeof(struct vnode_fdinfowithpath))
585 #define PROC_PIDFDSOCKETINFO 3
586 #define PROC_PIDFDSOCKETINFO_SIZE (sizeof(struct socket_fdinfo))
588 #define PROC_PIDFDPSEMINFO 4
589 #define PROC_PIDFDPSEMINFO_SIZE (sizeof(struct psem_fdinfo))
591 #define PROC_PIDFDPSHMINFO 5
592 #define PROC_PIDFDPSHMINFO_SIZE (sizeof(struct pshm_fdinfo))
594 #define PROC_PIDFDPIPEINFO 6
595 #define PROC_PIDFDPIPEINFO_SIZE (sizeof(struct pipe_fdinfo))
597 #define PROC_PIDFDKQUEUEINFO 7
598 #define PROC_PIDFDKQUEUEINFO_SIZE (sizeof(struct kqueue_fdinfo))
600 #define PROC_PIDFDATALKINFO 8
601 #define PROC_PIDFDATALKINFO_SIZE (sizeof(struct appletalk_fdinfo))
605 #ifdef XNU_KERNEL_PRIVATE
606 extern int fill_socketinfo(socket_t so
, struct socket_info
*si
);
607 extern int fill_pshminfo(struct pshmnode
* pshm
, struct pshm_info
* pinfo
);
608 extern int fill_pseminfo(struct psemnode
* psem
, struct psem_info
* pinfo
);
609 extern int fill_pipeinfo(struct pipe
* cpipe
, struct pipe_info
* pinfo
);
610 extern int fill_kqueueinfo(struct kqueue
* kq
, struct kqueue_info
* kinfo
);
611 #endif /* XNU_KERNEL_PRIVATE */
616 #endif /*_SYS_PROC_INFO_H */