bsd/sys/proc_info.h

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