]> git.saurik.com Git - apple/xnu.git/blame - bsd/sys/proc_info.h
projects / apple / xnu.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
xnu-4903.221.2.tar.gz
[apple/xnu.git] / bsd / sys / proc_info.h
CommitLineData
0c530ab8 1/*
5ba3f43e 2 * Copyright (c) 2005-2017 Apple Computer, Inc. All rights reserved.
0c530ab8 3 *
2d21ac55
A		 4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5 *
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.
14 *
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
17 *
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
0c530ab8
A		 20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
2d21ac55
A		 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.
25 *
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
0c530ab8
A		 27 */
28
29#ifndef _SYS_PROC_INFO_H
30#define _SYS_PROC_INFO_H
31
32#include <sys/cdefs.h>
33#include <sys/param.h>
34#include <sys/types.h>
35#include <sys/stat.h>
36#include <sys/mount.h>
37#include <sys/socket.h>
38#include <sys/un.h>
39#include <sys/kern_control.h>
3e170ce0 40#include <sys/event.h>
0c530ab8
A		 41#include <net/if.h>
42#include <net/route.h>
43#include <netinet/in.h>
44#include <netinet/tcp.h>
fe8ab488 45#include <mach/machine.h>
39037602 46#include <uuid/uuid.h>
0c530ab8 47
3e170ce0
A		 48#ifdef PRIVATE
49#include <mach/coalition.h> /* COALITION_NUM_TYPES */
50#endif
51
0c530ab8
A		 52__BEGIN_DECLS
53
54
b0d623f7 55#define PROC_ALL_PIDS 1
0c530ab8
A		 56#define PROC_PGRP_ONLY 2
57#define PROC_TTY_ONLY 3
58#define PROC_UID_ONLY 4
59#define PROC_RUID_ONLY 5
6d2010ae 60#define PROC_PPID_ONLY 6
5ba3f43e 61#define PROC_KDBG_ONLY 7
0c530ab8
A		 62
63struct proc_bsdinfo {
64 uint32_t pbi_flags; /* 64bit; emulated etc */
65 uint32_t pbi_status;
66 uint32_t pbi_xstatus;
67 uint32_t pbi_pid;
68 uint32_t pbi_ppid;
69 uid_t pbi_uid;
70 gid_t pbi_gid;
71 uid_t pbi_ruid;
72 gid_t pbi_rgid;
73 uid_t pbi_svuid;
74 gid_t pbi_svgid;
b0d623f7
A		 75 uint32_t rfu_1; /* reserved */
76 char pbi_comm[MAXCOMLEN];
77 char pbi_name[2*MAXCOMLEN]; /* empty if no name is registered */
0c530ab8
A		 78 uint32_t pbi_nfiles;
79 uint32_t pbi_pgid;
80 uint32_t pbi_pjobc;
81 uint32_t e_tdev; /* controlling tty dev */
82 uint32_t e_tpgid; /* tty process group id */
0c530ab8 83 int32_t pbi_nice;
b0d623f7
A		 84 uint64_t pbi_start_tvsec;
85 uint64_t pbi_start_tvusec;
0c530ab8
A		 86};
87
88
6d2010ae
A		 89struct proc_bsdshortinfo {
90 uint32_t pbsi_pid; /* process id */
91 uint32_t pbsi_ppid; /* process parent id */
92 uint32_t pbsi_pgid; /* process perp id */
93 uint32_t pbsi_status; /* p_stat value, SZOMB, SRUN, etc */
94 char pbsi_comm[MAXCOMLEN]; /* upto 16 characters of process name */
95 uint32_t pbsi_flags; /* 64bit; emulated etc */
96 uid_t pbsi_uid; /* current uid on process */
97 gid_t pbsi_gid; /* current gid on process */
98 uid_t pbsi_ruid; /* current ruid on process */
99 gid_t pbsi_rgid; /* current tgid on process */
100 uid_t pbsi_svuid; /* current svuid on process */
101 gid_t pbsi_svgid; /* current svgid on process */
102 uint32_t pbsi_rfu; /* reserved for future use*/
103};
104
0c530ab8 105
39236c6e
A		 106#ifdef PRIVATE
107struct proc_uniqidentifierinfo {
108 uint8_t p_uuid[16]; /* UUID of the main executable */
109 uint64_t p_uniqueid; /* 64 bit unique identifier for process */
110 uint64_t p_puniqueid; /* unique identifier for process's parent */
111 uint64_t p_reserve2; /* reserved for future use */
112 uint64_t p_reserve3; /* reserved for future use */
113 uint64_t p_reserve4; /* reserved for future use */
114};
115
116
117struct proc_bsdinfowithuniqid {
118 struct proc_bsdinfo pbsd;
119 struct proc_uniqidentifierinfo p_uniqidentifier;
120};
fe8ab488
A		 121
122struct proc_archinfo {
123 cpu_type_t p_cputype;
124 cpu_subtype_t p_cpusubtype;
125};
126
127struct proc_pidcoalitioninfo {
3e170ce0 128 uint64_t coalition_id[COALITION_NUM_TYPES];
fe8ab488
A		 129 uint64_t reserved1;
130 uint64_t reserved2;
131 uint64_t reserved3;
132};
133
3e170ce0
A		 134struct proc_originatorinfo {
135 uuid_t originator_uuid; /* UUID of the originator process */
136 pid_t originator_pid; /* pid of the originator process */
137 uint64_t p_reserve2;
138 uint64_t p_reserve3;
139 uint64_t p_reserve4;
140};
141
39236c6e
A		 142#endif
143
144
0c530ab8 145/* pbi_flags values */
6d2010ae
A		 146#define PROC_FLAG_SYSTEM 1 /* System process */
147#define PROC_FLAG_TRACED 2 /* process currently being traced, possibly by gdb */
148#define PROC_FLAG_INEXIT 4 /* process is working its way in exit() */
0c530ab8 149#define PROC_FLAG_PPWAIT 8
6d2010ae
A		 150#define PROC_FLAG_LP64 0x10 /* 64bit process */
151#define PROC_FLAG_SLEADER 0x20 /* The process is the session leader */
152#define PROC_FLAG_CTTY 0x40 /* process has a control tty */
153#define PROC_FLAG_CONTROLT 0x80 /* Has a controlling terminal */
154#define PROC_FLAG_THCWD 0x100 /* process has a thread with cwd */
b0d623f7 155/* process control bits for resource starvation */
6d2010ae
A		 156#define PROC_FLAG_PC_THROTTLE 0x200 /* In resource starvation situations, this process is to be throttled */
157#define PROC_FLAG_PC_SUSP 0x400 /* In resource starvation situations, this process is to be suspended */
158#define PROC_FLAG_PC_KILL 0x600 /* In resource starvation situations, this process is to be terminated */
b0d623f7
A		 159#define PROC_FLAG_PC_MASK 0x600
160/* process action bits for resource starvation */
6d2010ae
A		 161#define PROC_FLAG_PA_THROTTLE 0x800 /* The process is currently throttled due to resource starvation */
162#define PROC_FLAG_PA_SUSP 0x1000 /* The process is currently suspended due to resource starvation */
163#define PROC_FLAG_PSUGID 0x2000 /* process has set privileges since last exec */
164#define PROC_FLAG_EXEC 0x4000 /* process has called exec */
165#ifdef PRIVATE
166#define PROC_FLAG_DARWINBG 0x8000 /* process in darwin background */
167#define PROC_FLAG_EXT_DARWINBG 0x10000 /* process in darwin background - external enforcement */
39236c6e
A		 168#define PROC_FLAG_IOS_APPLEDAEMON 0x20000 /* Process is apple daemon */
169#define PROC_FLAG_DELAYIDLESLEEP 0x40000 /* Process is marked to delay idle sleep on disk IO */
170#define PROC_FLAG_IOS_IMPPROMOTION 0x80000 /* Process is daemon which receives importane donation */
171#define PROC_FLAG_ADAPTIVE 0x100000 /* Process is adaptive */
172#define PROC_FLAG_ADAPTIVE_IMPORTANT 0x200000 /* Process is adaptive, and is currently important */
173#define PROC_FLAG_IMPORTANCE_DONOR 0x400000 /* Process is marked as an importance donor */
174#define PROC_FLAG_SUPPRESSED 0x800000 /* Process is suppressed */
fe8ab488
A		 175#define PROC_FLAG_APPLICATION 0x1000000 /* Process is an application */
176#define PROC_FLAG_IOS_APPLICATION PROC_FLAG_APPLICATION /* Process is an application */
6d2010ae 177#endif
0c530ab8
A		 178
179
180struct proc_taskinfo {
b0d623f7
A		 181 uint64_t pti_virtual_size; /* virtual memory size (bytes) */
182 uint64_t pti_resident_size; /* resident memory size (bytes) */
0c530ab8
A		 183 uint64_t pti_total_user; /* total time */
184 uint64_t pti_total_system;
185 uint64_t pti_threads_user; /* existing threads only */
186 uint64_t pti_threads_system;
187 int32_t pti_policy; /* default policy for new threads */
188 int32_t pti_faults; /* number of page faults */
b0d623f7
A		 189 int32_t pti_pageins; /* number of actual pageins */
190 int32_t pti_cow_faults; /* number of copy-on-write faults */
0c530ab8 191 int32_t pti_messages_sent; /* number of messages sent */
b0d623f7
A		 192 int32_t pti_messages_received; /* number of messages received */
193 int32_t pti_syscalls_mach; /* number of mach system calls */
194 int32_t pti_syscalls_unix; /* number of unix system calls */
195 int32_t pti_csw; /* number of context switches */
0c530ab8
A		 196 int32_t pti_threadnum; /* number of threads in the task */
197 int32_t pti_numrunning; /* number of running threads */
198 int32_t pti_priority; /* task priority*/
199};
200
201struct proc_taskallinfo {
b0d623f7
A		 202 struct proc_bsdinfo pbsd;
203 struct proc_taskinfo ptinfo;
0c530ab8
A		 204};
205
b0d623f7 206#define MAXTHREADNAMESIZE 64
0c530ab8
A		 207
208struct proc_threadinfo {
b0d623f7
A		 209 uint64_t pth_user_time; /* user run time */
210 uint64_t pth_system_time; /* system run time */
211 int32_t pth_cpu_usage; /* scaled cpu usage percentage */
0c530ab8 212 int32_t pth_policy; /* scheduling policy in effect */
b0d623f7
A		 213 int32_t pth_run_state; /* run state (see below) */
214 int32_t pth_flags; /* various flags (see below) */
215 int32_t pth_sleep_time; /* number of seconds that thread */
0c530ab8
A		 216 int32_t pth_curpri; /* cur priority*/
217 int32_t pth_priority; /* priority*/
b0d623f7
A		 218 int32_t pth_maxpriority; /* max priority*/
219 char pth_name[MAXTHREADNAMESIZE]; /* thread name, if any */
0c530ab8
A		 220};
221
222struct proc_regioninfo {
223 uint32_t pri_protection;
224 uint32_t pri_max_protection;
225 uint32_t pri_inheritance;
226 uint32_t pri_flags; /* shared, external pager, is submap */
227 uint64_t pri_offset;
228 uint32_t pri_behavior;
229 uint32_t pri_user_wired_count;
230 uint32_t pri_user_tag;
231 uint32_t pri_pages_resident;
232 uint32_t pri_pages_shared_now_private;
b0d623f7
A		 233 uint32_t pri_pages_swapped_out;
234 uint32_t pri_pages_dirtied;
235 uint32_t pri_ref_count;
236 uint32_t pri_shadow_depth;
237 uint32_t pri_share_mode;
0c530ab8
A		 238 uint32_t pri_private_pages_resident;
239 uint32_t pri_shared_pages_resident;
240 uint32_t pri_obj_id;
2d21ac55 241 uint32_t pri_depth;
0c530ab8
A		 242 uint64_t pri_address;
243 uint64_t pri_size;
0c530ab8
A		 244};
245
246#define PROC_REGION_SUBMAP 1
247#define PROC_REGION_SHARED 2
248
249#define SM_COW 1
250#define SM_PRIVATE 2
251#define SM_EMPTY 3
252#define SM_SHARED 4
253#define SM_TRUESHARED 5
254#define SM_PRIVATE_ALIASED 6
255#define SM_SHARED_ALIASED 7
6d2010ae 256#define SM_LARGE_PAGE 8
0c530ab8
A		 257
258
259/*
260 * Thread run states (state field).
261 */
262
263#define TH_STATE_RUNNING 1 /* thread is running normally */
264#define TH_STATE_STOPPED 2 /* thread is stopped */
265#define TH_STATE_WAITING 3 /* thread is waiting normally */
266#define TH_STATE_UNINTERRUPTIBLE 4 /* thread is in an uninterruptible
267 wait */
268#define TH_STATE_HALTED 5 /* thread is halted at a
269 clean point */
270
271/*
272 * Thread flags (flags field).
273 */
274#define TH_FLAGS_SWAPPED 0x1 /* thread is swapped out */
275#define TH_FLAGS_IDLE 0x2 /* thread is an idle thread */
276
277
b0d623f7
A		 278struct proc_workqueueinfo {
279 uint32_t pwq_nthreads; /* total number of workqueue threads */
280 uint32_t pwq_runthreads; /* total number of running workqueue threads */
281 uint32_t pwq_blockedthreads; /* total number of blocked workqueue threads */
6d2010ae 282 uint32_t pwq_state;
b0d623f7 283};
0c530ab8 284
6d2010ae
A		 285/*
286 * workqueue state (pwq_state field)
287 */
39037602
A		 288#define WQ_EXCEEDED_CONSTRAINED_THREAD_LIMIT 0x1
289#define WQ_EXCEEDED_TOTAL_THREAD_LIMIT 0x2
290#define WQ_FLAGS_AVAILABLE 0x4
6d2010ae 291
0c530ab8
A		 292struct proc_fileinfo {
293 uint32_t fi_openflags;
294 uint32_t fi_status;
295 off_t fi_offset;
296 int32_t fi_type;
39236c6e 297 uint32_t fi_guardflags;
0c530ab8
A		 298};
299
2d21ac55
A		 300/* stats flags in proc_fileinfo */
301#define PROC_FP_SHARED 1 /* shared by more than one fd */
302#define PROC_FP_CLEXEC 2 /* close on exec */
39236c6e 303#define PROC_FP_GUARDED 4 /* guarded fd */
3e170ce0 304#define PROC_FP_CLFORK 8 /* close on fork */
39236c6e
A		 305
306#define PROC_FI_GUARD_CLOSE (1u << 0)
307#define PROC_FI_GUARD_DUP (1u << 1)
308#define PROC_FI_GUARD_SOCKET_IPC (1u << 2)
309#define PROC_FI_GUARD_FILEPORT (1u << 3)
2d21ac55 310
39037602
A		 311struct proc_exitreasonbasicinfo {
312 uint32_t beri_namespace;
313 uint64_t beri_code;
314 uint64_t beri_flags;
315 uint32_t beri_reason_buf_size;
316} __attribute__((packed));
317
318struct proc_exitreasoninfo {
319 uint32_t eri_namespace;
320 uint64_t eri_code;
321 uint64_t eri_flags;
322 uint32_t eri_reason_buf_size;
323 uint64_t eri_kcd_buf;
324} __attribute__((packed));
325
2d21ac55
A		 326/*
327 * A copy of stat64 with static sized fields.
328 */
329struct vinfo_stat {
330 uint32_t vst_dev; /* [XSI] ID of device containing file */
331 uint16_t vst_mode; /* [XSI] Mode of file (see below) */
332 uint16_t vst_nlink; /* [XSI] Number of hard links */
333 uint64_t vst_ino; /* [XSI] File serial number */
334 uid_t vst_uid; /* [XSI] User ID of the file */
335 gid_t vst_gid; /* [XSI] Group ID of the file */
336 int64_t vst_atime; /* [XSI] Time of last access */
337 int64_t vst_atimensec; /* nsec of last access */
338 int64_t vst_mtime; /* [XSI] Last data modification time */
339 int64_t vst_mtimensec; /* last data modification nsec */
340 int64_t vst_ctime; /* [XSI] Time of last status change */
341 int64_t vst_ctimensec; /* nsec of last status change */
342 int64_t vst_birthtime; /* File creation time(birth) */
343 int64_t vst_birthtimensec; /* nsec of File creation time */
344 off_t vst_size; /* [XSI] file size, in bytes */
345 int64_t vst_blocks; /* [XSI] blocks allocated for file */
346 int32_t vst_blksize; /* [XSI] optimal blocksize for I/O */
347 uint32_t vst_flags; /* user defined flags for file */
348 uint32_t vst_gen; /* file generation number */
349 uint32_t vst_rdev; /* [XSI] Device ID */
350 int64_t vst_qspare[2]; /* RESERVED: DO NOT USE! */
351};
0c530ab8
A		 352
353struct vnode_info {
2d21ac55
A		 354 struct vinfo_stat vi_stat;
355 int vi_type;
2d21ac55 356 int vi_pad;
b0d623f7 357 fsid_t vi_fsid;
0c530ab8
A		 358};
359
360struct vnode_info_path {
361 struct vnode_info vip_vi;
b0d623f7 362 char vip_path[MAXPATHLEN]; /* tail end of it */
0c530ab8
A		 363};
364
365struct vnode_fdinfo {
2d21ac55 366 struct proc_fileinfo pfi;
0c530ab8
A		 367 struct vnode_info pvi;
368};
369
370struct vnode_fdinfowithpath {
b0d623f7
A		 371 struct proc_fileinfo pfi;
372 struct vnode_info_path pvip;
0c530ab8
A		 373};
374
0c530ab8 375struct proc_regionwithpathinfo {
b0d623f7
A		 376 struct proc_regioninfo prp_prinfo;
377 struct vnode_info_path prp_vip;
0c530ab8
A		 378};
379
380struct proc_vnodepathinfo {
b0d623f7
A		 381 struct vnode_info_path pvi_cdir;
382 struct vnode_info_path pvi_rdir;
0c530ab8
A		 383};
384
2d21ac55 385struct proc_threadwithpathinfo {
b0d623f7
A		 386 struct proc_threadinfo pt;
387 struct vnode_info_path pvip;
2d21ac55 388};
0c530ab8
A		 389
390/*
391 * Socket
392 */
393
394
395/*
396 * IPv4 and IPv6 Sockets
397 */
398
399#define INI_IPV4 0x1
400#define INI_IPV6 0x2
401
402struct in4in6_addr {
b0d623f7
A		 403 u_int32_t i46a_pad32[3];
404 struct in_addr i46a_addr4;
0c530ab8
A		 405};
406
407struct in_sockinfo {
b0d623f7
A		 408 int insi_fport; /* foreign port */
409 int insi_lport; /* local port */
0c530ab8
A		 410 uint64_t insi_gencnt; /* generation count of this instance */
411 uint32_t insi_flags; /* generic IP/datagram flags */
412 uint32_t insi_flow;
413
414 uint8_t insi_vflag; /* ini_IPV4 or ini_IPV6 */
b0d623f7
A		 415 uint8_t insi_ip_ttl; /* time to live proto */
416 uint32_t rfu_1; /* reserved */
0c530ab8
A		 417 /* protocol dependent part */
418 union {
b0d623f7
A		 419 struct in4in6_addr ina_46;
420 struct in6_addr ina_6;
421 } insi_faddr; /* foreign host table entry */
0c530ab8 422 union {
b0d623f7
A		 423 struct in4in6_addr ina_46;
424 struct in6_addr ina_6;
425 } insi_laddr; /* local host table entry */
0c530ab8 426 struct {
b0d623f7
A		 427 u_char in4_tos; /* type of service */
428 } insi_v4;
0c530ab8 429 struct {
b0d623f7
A		 430 uint8_t in6_hlim;
431 int in6_cksum;
432 u_short in6_ifindex;
433 short in6_hops;
434 } insi_v6;
0c530ab8
A		 435};
436
437/*
438 * TCP Sockets
439 */
440
b0d623f7
A		 441#define TSI_T_REXMT 0 /* retransmit */
442#define TSI_T_PERSIST 1 /* retransmit persistence */
443#define TSI_T_KEEP 2 /* keep alive */
444#define TSI_T_2MSL 3 /* 2*msl quiet time timer */
0c530ab8
A		 445#define TSI_T_NTIMERS 4
446
b0d623f7
A		 447#define TSI_S_CLOSED 0 /* closed */
448#define TSI_S_LISTEN 1 /* listening for connection */
449#define TSI_S_SYN_SENT 2 /* active, have sent syn */
450#define TSI_S_SYN_RECEIVED 3 /* have send and received syn */
451#define TSI_S_ESTABLISHED 4 /* established */
452#define TSI_S__CLOSE_WAIT 5 /* rcvd fin, waiting for close */
453#define TSI_S_FIN_WAIT_1 6 /* have closed, sent fin */
454#define TSI_S_CLOSING 7 /* closed xchd FIN; await FIN ACK */
455#define TSI_S_LAST_ACK 8 /* had fin and close; await FIN ACK */
456#define TSI_S_FIN_WAIT_2 9 /* have closed, fin is acked */
457#define TSI_S_TIME_WAIT 10 /* in 2*msl quiet wait after close */
458#define TSI_S_RESERVED 11 /* pseudo state: reserved */
0c530ab8
A		 459
460struct tcp_sockinfo {
b0d623f7
A		 461 struct in_sockinfo tcpsi_ini;
462 int tcpsi_state;
463 int tcpsi_timer[TSI_T_NTIMERS];
464 int tcpsi_mss;
465 uint32_t tcpsi_flags;
466 uint32_t rfu_1; /* reserved */
467 uint64_t tcpsi_tp; /* opaque handle of TCP protocol control block */
0c530ab8
A		 468};
469
470/*
471 * Unix Domain Sockets
472 */
473
474
475struct un_sockinfo {
b0d623f7
A		 476 uint64_t unsi_conn_so; /* opaque handle of connected socket */
477 uint64_t unsi_conn_pcb; /* opaque handle of connected protocol control block */
0c530ab8 478 union {
b0d623f7
A		 479 struct sockaddr_un ua_sun;
480 char ua_dummy[SOCK_MAXADDRLEN];
481 } unsi_addr; /* bound address */
0c530ab8 482 union {
b0d623f7
A		 483 struct sockaddr_un ua_sun;
484 char ua_dummy[SOCK_MAXADDRLEN];
485 } unsi_caddr; /* address of socket connected to */
0c530ab8
A		 486};
487
488/*
489 * PF_NDRV Sockets
490 */
491
492struct ndrv_info {
b0d623f7
A		 493 uint32_t ndrvsi_if_family;
494 uint32_t ndrvsi_if_unit;
495 char ndrvsi_if_name[IF_NAMESIZE];
0c530ab8
A		 496};
497
498/*
499 * Kernel Event Sockets
500 */
501
502struct kern_event_info {
b0d623f7
A		 503 uint32_t kesi_vendor_code_filter;
504 uint32_t kesi_class_filter;
505 uint32_t kesi_subclass_filter;
0c530ab8
A		 506};
507
508/*
509 * Kernel Control Sockets
510 */
511
512struct kern_ctl_info {
b0d623f7
A		 513 uint32_t kcsi_id;
514 uint32_t kcsi_reg_unit;
515 uint32_t kcsi_flags; /* support flags */
516 uint32_t kcsi_recvbufsize; /* request more than the default buffer size */
517 uint32_t kcsi_sendbufsize; /* request more than the default buffer size */
518 uint32_t kcsi_unit;
519 char kcsi_name[MAX_KCTL_NAME]; /* unique nke identifier, provided by DTS */
0c530ab8
A		 520};
521
522/* soi_state */
523
b0d623f7
A		 524#define SOI_S_NOFDREF 0x0001 /* no file table ref any more */
525#define SOI_S_ISCONNECTED 0x0002 /* socket connected to a peer */
526#define SOI_S_ISCONNECTING 0x0004 /* in process of connecting to peer */
527#define SOI_S_ISDISCONNECTING 0x0008 /* in process of disconnecting */
528#define SOI_S_CANTSENDMORE 0x0010 /* can't send more data to peer */
529#define SOI_S_CANTRCVMORE 0x0020 /* can't receive more data from peer */
530#define SOI_S_RCVATMARK 0x0040 /* at mark on input */
531#define SOI_S_PRIV 0x0080 /* privileged for broadcast, raw... */
532#define SOI_S_NBIO 0x0100 /* non-blocking ops */
533#define SOI_S_ASYNC 0x0200 /* async i/o notify */
534#define SOI_S_INCOMP 0x0800 /* Unaccepted, incomplete connection */
535#define SOI_S_COMP 0x1000 /* unaccepted, complete connection */
536#define SOI_S_ISDISCONNECTED 0x2000 /* socket disconnected from peer */
537#define SOI_S_DRAINING 0x4000 /* close waiting for blocked system calls to drain */
0c530ab8
A		 538
539struct sockbuf_info {
b0d623f7
A		 540 uint32_t sbi_cc;
541 uint32_t sbi_hiwat; /* SO_RCVBUF, SO_SNDBUF */
542 uint32_t sbi_mbcnt;
543 uint32_t sbi_mbmax;
544 uint32_t sbi_lowat;
545 short sbi_flags;
546 short sbi_timeo;
0c530ab8
A		 547};
548
549enum {
b0d623f7
A		 550 SOCKINFO_GENERIC = 0,
551 SOCKINFO_IN = 1,
0c530ab8 552 SOCKINFO_TCP = 2,
b0d623f7 553 SOCKINFO_UN = 3,
0c530ab8
A		 554 SOCKINFO_NDRV = 4,
555 SOCKINFO_KERN_EVENT = 5,
556 SOCKINFO_KERN_CTL = 6
557};
558
559struct socket_info {
b0d623f7 560 struct vinfo_stat soi_stat;
0c530ab8
A		 561 uint64_t soi_so; /* opaque handle of socket */
562 uint64_t soi_pcb; /* opaque handle of protocol control block */
b0d623f7
A		 563 int soi_type;
564 int soi_protocol;
565 int soi_family;
0c530ab8
A		 566 short soi_options;
567 short soi_linger;
568 short soi_state;
569 short soi_qlen;
570 short soi_incqlen;
571 short soi_qlimit;
572 short soi_timeo;
573 u_short soi_error;
574 uint32_t soi_oobmark;
b0d623f7
A		 575 struct sockbuf_info soi_rcv;
576 struct sockbuf_info soi_snd;
577 int soi_kind;
578 uint32_t rfu_1; /* reserved */
0c530ab8 579 union {
b0d623f7
A		 580 struct in_sockinfo pri_in; /* SOCKINFO_IN */
581 struct tcp_sockinfo pri_tcp; /* SOCKINFO_TCP */
582 struct un_sockinfo pri_un; /* SOCKINFO_UN */
583 struct ndrv_info pri_ndrv; /* SOCKINFO_NDRV */
584 struct kern_event_info pri_kern_event; /* SOCKINFO_KERN_EVENT */
585 struct kern_ctl_info pri_kern_ctl; /* SOCKINFO_KERN_CTL */
586 } soi_proto;
0c530ab8
A		 587};
588
589struct socket_fdinfo {
b0d623f7
A		 590 struct proc_fileinfo pfi;
591 struct socket_info psi;
0c530ab8
A		 592};
593
594
595
596struct psem_info {
b0d623f7 597 struct vinfo_stat psem_stat;
0c530ab8
A		 598 char psem_name[MAXPATHLEN];
599};
600
601struct psem_fdinfo {
b0d623f7 602 struct proc_fileinfo pfi;
0c530ab8
A		 603 struct psem_info pseminfo;
604};
605
606
607
608struct pshm_info {
b0d623f7 609 struct vinfo_stat pshm_stat;
0c530ab8
A		 610 uint64_t pshm_mappaddr;
611 char pshm_name[MAXPATHLEN];
612};
613
614struct pshm_fdinfo {
b0d623f7
A		 615 struct proc_fileinfo pfi;
616 struct pshm_info pshminfo;
0c530ab8
A		 617};
618
619
620struct pipe_info {
b0d623f7
A		 621 struct vinfo_stat pipe_stat;
622 uint64_t pipe_handle;
623 uint64_t pipe_peerhandle;
0c530ab8 624 int pipe_status;
b0d623f7 625 int rfu_1; /* reserved */
0c530ab8
A		 626};
627
628struct pipe_fdinfo {
b0d623f7 629 struct proc_fileinfo pfi;
0c530ab8
A		 630 struct pipe_info pipeinfo;
631};
632
633
634struct kqueue_info {
b0d623f7
A		 635 struct vinfo_stat kq_stat;
636 uint32_t kq_state;
637 uint32_t rfu_1; /* reserved */
0c530ab8 638};
3e170ce0 639
5ba3f43e
A		 640struct kqueue_dyninfo {
641 struct kqueue_info kqdi_info;
642 uint64_t kqdi_servicer;
643 uint64_t kqdi_owner;
644 uint32_t kqdi_sync_waiters;
645 uint8_t kqdi_sync_waiter_qos;
646 uint8_t kqdi_async_qos;
647 uint16_t kqdi_request_state;
648 uint8_t kqdi_events_qos;
d9a64523
A		 649 uint8_t kqdi_pri;
650 uint8_t kqdi_pol;
651 uint8_t kqdi_cpupercent;
652 uint8_t _kqdi_reserved0[4];
5ba3f43e
A		 653 uint64_t _kqdi_reserved1[4];
654};
655
3e170ce0
A		 656/* keep in sync with KQ_* in sys/eventvar.h */
657#define PROC_KQUEUE_SELECT 0x01
658#define PROC_KQUEUE_SLEEP 0x02
659#define PROC_KQUEUE_32 0x08
660#define PROC_KQUEUE_64 0x10
661#define PROC_KQUEUE_QOS 0x20
662
663#ifdef PRIVATE
664struct kevent_extinfo {
665 struct kevent_qos_s kqext_kev;
666 uint64_t kqext_sdata;
667 int kqext_status;
668 int kqext_sfflags;
669 uint64_t kqext_reserved[2];
670};
671#endif /* PRIVATE */
0c530ab8
A		 672
673struct kqueue_fdinfo {
b0d623f7 674 struct proc_fileinfo pfi;
0c530ab8
A		 675 struct kqueue_info kqueueinfo;
676};
677
678struct appletalk_info {
b0d623f7 679 struct vinfo_stat atalk_stat;
0c530ab8
A		 680};
681
682struct appletalk_fdinfo {
b0d623f7
A		 683 struct proc_fileinfo pfi;
684 struct appletalk_info appletalkinfo;
0c530ab8
A		 685};
686
a39ff7e2 687typedef uint64_t proc_info_udata_t;
0c530ab8
A		 688
689/* defns of process file desc type */
b0d623f7
A		 690#define PROX_FDTYPE_ATALK 0
691#define PROX_FDTYPE_VNODE 1
692#define PROX_FDTYPE_SOCKET 2
693#define PROX_FDTYPE_PSHM 3
694#define PROX_FDTYPE_PSEM 4
695#define PROX_FDTYPE_KQUEUE 5
696#define PROX_FDTYPE_PIPE 6
697#define PROX_FDTYPE_FSEVENTS 7
39037602 698#define PROX_FDTYPE_NETPOLICY 9
0c530ab8
A		 699
700struct proc_fdinfo {
b0d623f7
A		 701 int32_t proc_fd;
702 uint32_t proc_fdtype;
0c530ab8
A		 703};
704
6d2010ae
A		 705struct proc_fileportinfo {
706 uint32_t proc_fileport;
707 uint32_t proc_fdtype;
708};
709
39037602 710
b0d623f7
A		 711/* Flavors for proc_pidinfo() */
712#define PROC_PIDLISTFDS 1
713#define PROC_PIDLISTFD_SIZE (sizeof(struct proc_fdinfo))
0c530ab8 714
b0d623f7
A		 715#define PROC_PIDTASKALLINFO 2
716#define PROC_PIDTASKALLINFO_SIZE (sizeof(struct proc_taskallinfo))
0c530ab8 717
b0d623f7
A		 718#define PROC_PIDTBSDINFO 3
719#define PROC_PIDTBSDINFO_SIZE (sizeof(struct proc_bsdinfo))
0c530ab8 720
b0d623f7
A		 721#define PROC_PIDTASKINFO 4
722#define PROC_PIDTASKINFO_SIZE (sizeof(struct proc_taskinfo))
0c530ab8 723
b0d623f7
A		 724#define PROC_PIDTHREADINFO 5
725#define PROC_PIDTHREADINFO_SIZE (sizeof(struct proc_threadinfo))
0c530ab8 726
b0d623f7
A		 727#define PROC_PIDLISTTHREADS 6
728#define PROC_PIDLISTTHREADS_SIZE (2* sizeof(uint32_t))
0c530ab8 729
b0d623f7
A		 730#define PROC_PIDREGIONINFO 7
731#define PROC_PIDREGIONINFO_SIZE (sizeof(struct proc_regioninfo))
0c530ab8 732
b0d623f7
A		 733#define PROC_PIDREGIONPATHINFO 8
734#define PROC_PIDREGIONPATHINFO_SIZE (sizeof(struct proc_regionwithpathinfo))
0c530ab8 735
b0d623f7
A		 736#define PROC_PIDVNODEPATHINFO 9
737#define PROC_PIDVNODEPATHINFO_SIZE (sizeof(struct proc_vnodepathinfo))
0c530ab8 738
b0d623f7
A		 739#define PROC_PIDTHREADPATHINFO 10
740#define PROC_PIDTHREADPATHINFO_SIZE (sizeof(struct proc_threadwithpathinfo))
2d21ac55 741
b0d623f7
A		 742#define PROC_PIDPATHINFO 11
743#define PROC_PIDPATHINFO_SIZE (MAXPATHLEN)
744#define PROC_PIDPATHINFO_MAXSIZE (4*MAXPATHLEN)
2d21ac55 745
b0d623f7
A		 746#define PROC_PIDWORKQUEUEINFO 12
747#define PROC_PIDWORKQUEUEINFO_SIZE (sizeof(struct proc_workqueueinfo))
0c530ab8 748
6d2010ae
A		 749#define PROC_PIDT_SHORTBSDINFO 13
750#define PROC_PIDT_SHORTBSDINFO_SIZE (sizeof(struct proc_bsdshortinfo))
751
752#define PROC_PIDLISTFILEPORTS 14
753#define PROC_PIDLISTFILEPORTS_SIZE (sizeof(struct proc_fileportinfo))
754
316670eb
A		 755#define PROC_PIDTHREADID64INFO 15
756#define PROC_PIDTHREADID64INFO_SIZE (sizeof(struct proc_threadinfo))
757
39236c6e
A		 758#define PROC_PID_RUSAGE 16
759#define PROC_PID_RUSAGE_SIZE 0
760
761#ifdef PRIVATE
762#define PROC_PIDUNIQIDENTIFIERINFO 17
763#define PROC_PIDUNIQIDENTIFIERINFO_SIZE \
764 (sizeof(struct proc_uniqidentifierinfo))
765
766#define PROC_PIDT_BSDINFOWITHUNIQID 18
767#define PROC_PIDT_BSDINFOWITHUNIQID_SIZE \
768 (sizeof(struct proc_bsdinfowithuniqid))
fe8ab488
A		 769
770#define PROC_PIDARCHINFO 19
771#define PROC_PIDARCHINFO_SIZE \
772 (sizeof(struct proc_archinfo))
773
774#define PROC_PIDCOALITIONINFO 20
775#define PROC_PIDCOALITIONINFO_SIZE (sizeof(struct proc_pidcoalitioninfo))
776
777#define PROC_PIDNOTEEXIT 21
778#define PROC_PIDNOTEEXIT_SIZE (sizeof(uint32_t))
779
780#define PROC_PIDREGIONPATHINFO2 22
781#define PROC_PIDREGIONPATHINFO2_SIZE (sizeof(struct proc_regionwithpathinfo))
782
783#define PROC_PIDREGIONPATHINFO3 23
784#define PROC_PIDREGIONPATHINFO3_SIZE (sizeof(struct proc_regionwithpathinfo))
785
39037602
A		 786#define PROC_PIDEXITREASONINFO 24
787#define PROC_PIDEXITREASONINFO_SIZE (sizeof(struct proc_exitreasoninfo))
788
789#define PROC_PIDEXITREASONBASICINFO 25
790#define PROC_PIDEXITREASONBASICINFOSIZE (sizeof(struct proc_exitreasonbasicinfo))
791
5ba3f43e
A		 792#define PROC_PIDLISTUPTRS 26
793#define PROC_PIDLISTUPTRS_SIZE (sizeof(uint64_t))
794
795#define PROC_PIDLISTDYNKQUEUES 27
796#define PROC_PIDLISTDYNKQUEUES_SIZE (sizeof(kqueue_id_t))
797
d9a64523
A		 798#define PROC_PIDLISTTHREADIDS 28
799#define PROC_PIDLISTTHREADIDS_SIZE (2* sizeof(uint32_t))
39236c6e 800
d9a64523
A		 801#define PROC_PIDVMRTFAULTINFO 29
802#define PROC_PIDVMRTFAULTINFO_SIZE (7 * sizeof(uint64_t))
803#endif /* PRIVATE */
b0d623f7 804/* Flavors for proc_pidfdinfo */
0c530ab8 805
b0d623f7
A		 806#define PROC_PIDFDVNODEINFO 1
807#define PROC_PIDFDVNODEINFO_SIZE (sizeof(struct vnode_fdinfo))
0c530ab8 808
b0d623f7
A		 809#define PROC_PIDFDVNODEPATHINFO 2
810#define PROC_PIDFDVNODEPATHINFO_SIZE (sizeof(struct vnode_fdinfowithpath))
0c530ab8 811
b0d623f7
A		 812#define PROC_PIDFDSOCKETINFO 3
813#define PROC_PIDFDSOCKETINFO_SIZE (sizeof(struct socket_fdinfo))
0c530ab8 814
b0d623f7
A		 815#define PROC_PIDFDPSEMINFO 4
816#define PROC_PIDFDPSEMINFO_SIZE (sizeof(struct psem_fdinfo))
0c530ab8 817
b0d623f7
A		 818#define PROC_PIDFDPSHMINFO 5
819#define PROC_PIDFDPSHMINFO_SIZE (sizeof(struct pshm_fdinfo))
0c530ab8 820
b0d623f7
A		 821#define PROC_PIDFDPIPEINFO 6
822#define PROC_PIDFDPIPEINFO_SIZE (sizeof(struct pipe_fdinfo))
0c530ab8 823
b0d623f7
A		 824#define PROC_PIDFDKQUEUEINFO 7
825#define PROC_PIDFDKQUEUEINFO_SIZE (sizeof(struct kqueue_fdinfo))
0c530ab8 826
b0d623f7
A		 827#define PROC_PIDFDATALKINFO 8
828#define PROC_PIDFDATALKINFO_SIZE (sizeof(struct appletalk_fdinfo))
0c530ab8 829
3e170ce0
A		 830#ifdef PRIVATE
831#define PROC_PIDFDKQUEUE_EXTINFO 9
832#define PROC_PIDFDKQUEUE_EXTINFO_SIZE (sizeof(struct kevent_extinfo))
39037602 833#define PROC_PIDFDKQUEUE_KNOTES_MAX (1024 * 128)
5ba3f43e 834#define PROC_PIDDYNKQUEUES_MAX (1024 * 128)
3e170ce0
A		 835#endif /* PRIVATE */
836
39037602 837
6d2010ae
A		 838/* Flavors for proc_pidfileportinfo */
839
840#define PROC_PIDFILEPORTVNODEPATHINFO 2 /* out: vnode_fdinfowithpath */
841#define PROC_PIDFILEPORTVNODEPATHINFO_SIZE \
842 PROC_PIDFDVNODEPATHINFO_SIZE
843
844#define PROC_PIDFILEPORTSOCKETINFO 3 /* out: socket_fdinfo */
845#define PROC_PIDFILEPORTSOCKETINFO_SIZE PROC_PIDFDSOCKETINFO_SIZE
846
847#define PROC_PIDFILEPORTPSHMINFO 5 /* out: pshm_fdinfo */
848#define PROC_PIDFILEPORTPSHMINFO_SIZE PROC_PIDFDPSHMINFO_SIZE
849
850#define PROC_PIDFILEPORTPIPEINFO 6 /* out: pipe_fdinfo */
851#define PROC_PIDFILEPORTPIPEINFO_SIZE PROC_PIDFDPIPEINFO_SIZE
852
b0d623f7
A		 853/* used for proc_setcontrol */
854#define PROC_SELFSET_PCONTROL 1
0c530ab8 855
6d2010ae
A		 856#define PROC_SELFSET_THREADNAME 2
857#define PROC_SELFSET_THREADNAME_SIZE (MAXTHREADNAMESIZE -1)
858
859#define PROC_SELFSET_VMRSRCOWNER 3
860
316670eb
A		 861#define PROC_SELFSET_DELAYIDLESLEEP 4
862
863/* used for proc_dirtycontrol */
864#define PROC_DIRTYCONTROL_TRACK 1
865#define PROC_DIRTYCONTROL_SET 2
866#define PROC_DIRTYCONTROL_GET 3
fe8ab488 867#define PROC_DIRTYCONTROL_CLEAR 4
316670eb
A		 868
869/* proc_track_dirty() flags */
870#define PROC_DIRTY_TRACK 0x1
871#define PROC_DIRTY_ALLOW_IDLE_EXIT 0x2
39236c6e 872#define PROC_DIRTY_DEFER 0x4
fe8ab488 873#define PROC_DIRTY_LAUNCH_IN_PROGRESS 0x8
d9a64523 874#define PROC_DIRTY_DEFER_ALWAYS 0x10
316670eb
A		 875
876/* proc_get_dirty() flags */
877#define PROC_DIRTY_TRACKED 0x1
878#define PROC_DIRTY_ALLOWS_IDLE_EXIT 0x2
39236c6e 879#define PROC_DIRTY_IS_DIRTY 0x4
fe8ab488 880#define PROC_DIRTY_LAUNCH_IS_IN_PROGRESS 0x8
39236c6e 881
a39ff7e2
A		 882/* Flavors for proc_udata_info */
883#define PROC_UDATA_INFO_GET 1
884#define PROC_UDATA_INFO_SET 2
885
39236c6e
A		 886#ifdef PRIVATE
887
fe8ab488
A		 888/* Flavors for proc_pidoriginatorinfo */
889#define PROC_PIDORIGINATOR_UUID 0x1
890#define PROC_PIDORIGINATOR_UUID_SIZE (sizeof(uuid_t))
891
892#define PROC_PIDORIGINATOR_BGSTATE 0x2
893#define PROC_PIDORIGINATOR_BGSTATE_SIZE (sizeof(uint32_t))
894
3e170ce0
A		 895#define PROC_PIDORIGINATOR_PID_UUID 0x3
896#define PROC_PIDORIGINATOR_PID_UUID_SIZE (sizeof(struct proc_originatorinfo))
897
898/* Flavors for proc_listcoalitions */
899#define LISTCOALITIONS_ALL_COALS 1
900#define LISTCOALITIONS_ALL_COALS_SIZE (sizeof(struct procinfo_coalinfo))
901
902#define LISTCOALITIONS_SINGLE_TYPE 2
903#define LISTCOALITIONS_SINGLE_TYPE_SIZE (sizeof(struct procinfo_coalinfo))
904
4bd07ac2
A		 905/* reasons for proc_can_use_foreground_hw */
906#define PROC_FGHW_OK 0 /* pid may use foreground HW */
907#define PROC_FGHW_DAEMON_OK 1
908#define PROC_FGHW_DAEMON_LEADER 10 /* pid is in a daemon coalition */
909#define PROC_FGHW_LEADER_NONUI 11 /* coalition leader is in a non-focal state */
910#define PROC_FGHW_LEADER_BACKGROUND 12 /* coalition leader is in a background state */
911#define PROC_FGHW_DAEMON_NO_VOUCHER 13 /* pid is a daemon with no adopted voucher */
912#define PROC_FGHW_NO_VOUCHER_ATTR 14 /* pid has adopted a voucher with no bank/originator attribute */
913#define PROC_FGHW_NO_ORIGINATOR 15 /* pid has adopted a voucher for a process that's gone away */
914#define PROC_FGHW_ORIGINATOR_BACKGROUND 16 /* pid has adopted a voucher for an app that's in the background */
915#define PROC_FGHW_VOUCHER_ERROR 98 /* error in voucher / originator callout */
916#define PROC_FGHW_ERROR 99 /* syscall parameter/permissions error */
917
5ba3f43e 918/* flavors for proc_piddynkqueueinfo */
5ba3f43e
A		 919#define PROC_PIDDYNKQUEUE_INFO 0
920#define PROC_PIDDYNKQUEUE_INFO_SIZE (sizeof(struct kqueue_dyninfo))
921#define PROC_PIDDYNKQUEUE_EXTINFO 1
922#define PROC_PIDDYNKQUEUE_EXTINFO_SIZE (sizeof(struct kevent_extinfo))
5ba3f43e 923
39236c6e 924/* __proc_info() call numbers */
5ba3f43e
A		 925#define PROC_INFO_CALL_LISTPIDS 0x1
926#define PROC_INFO_CALL_PIDINFO 0x2
927#define PROC_INFO_CALL_PIDFDINFO 0x3
928#define PROC_INFO_CALL_KERNMSGBUF 0x4
929#define PROC_INFO_CALL_SETCONTROL 0x5
930#define PROC_INFO_CALL_PIDFILEPORTINFO 0x6
931#define PROC_INFO_CALL_TERMINATE 0x7
932#define PROC_INFO_CALL_DIRTYCONTROL 0x8
933#define PROC_INFO_CALL_PIDRUSAGE 0x9
fe8ab488 934#define PROC_INFO_CALL_PIDORIGINATORINFO 0xa
5ba3f43e
A		 935#define PROC_INFO_CALL_LISTCOALITIONS 0xb
936#define PROC_INFO_CALL_CANUSEFGHW 0xc
937#define PROC_INFO_CALL_PIDDYNKQUEUEINFO 0xd
a39ff7e2 938#define PROC_INFO_CALL_UDATA_INFO 0xe
39236c6e 939#endif /* PRIVATE */
316670eb 940
0c530ab8 941#ifdef XNU_KERNEL_PRIVATE
b0d623f7
A		 942#ifndef pshmnode
943struct pshmnode;
944#endif
945
946#ifndef psemnode
947struct psemnode ;
948#endif
949
950#ifndef pipe
951struct pipe;
952#endif
953
0c530ab8
A		 954extern int fill_socketinfo(socket_t so, struct socket_info *si);
955extern int fill_pshminfo(struct pshmnode * pshm, struct pshm_info * pinfo);
956extern int fill_pseminfo(struct psemnode * psem, struct psem_info * pinfo);
957extern int fill_pipeinfo(struct pipe * cpipe, struct pipe_info * pinfo);
958extern int fill_kqueueinfo(struct kqueue * kq, struct kqueue_info * kinfo);
39037602
A		 959extern int pid_kqueue_extinfo(proc_t, struct kqueue * kq, user_addr_t buffer,
960 uint32_t buffersize, int32_t * retval);
961extern int pid_kqueue_udatainfo(proc_t p, struct kqueue *kq, uint64_t *buf,
962 uint32_t bufsize);
5ba3f43e
A		 963extern int pid_kqueue_listdynamickqueues(proc_t p, user_addr_t ubuf,
964 uint32_t bufsize, int32_t *retval);
965extern int pid_dynamickqueue_extinfo(proc_t p, kqueue_id_t kq_id,
966 user_addr_t ubuf, uint32_t bufsize, int32_t *retval);
b0d623f7 967extern int fill_procworkqueue(proc_t, struct proc_workqueueinfo *);
39037602
A		 968extern boolean_t workqueue_get_pwq_exceeded(void *v, boolean_t *exceeded_total,
969 boolean_t *exceeded_constrained);
970extern uint32_t workqueue_get_pwq_state_kdp(void *proc);
971
0c530ab8
A		 972#endif /* XNU_KERNEL_PRIVATE */
973
0c530ab8
A		 974__END_DECLS
975
976#endif /*_SYS_PROC_INFO_H */
mirror of XNU