1.\" 2.\" This file and its contents are supplied under the terms of the 3.\" Common Development and Distribution License ("CDDL"), version 1.0. 4.\" You may only use this file in accordance with the terms of version 5.\" 1.0 of the CDDL. 6.\" 7.\" A full copy of the text of the CDDL should have accompanied this 8.\" source. A copy of the CDDL is also available via the Internet at 9.\" http://www.illumos.org/license/CDDL. 10.\" 11.\" 12.\" Copyright 2018 Joyent, Inc. 13.\" Copyright (c) 2019 Carlos Neira <cneirabustos@gmail.com> 14.\" Copyright 2020 OmniOS Community Edition (OmniOSce) Association. 15.\" Copyright 2023 Oxide Computer Company 16.\" 17.Dd March 20, 2023 18.Dt LIBPROC 3LIB 19.Os 20.Sh NAME 21.Nm libproc 22.Nd process control library 23.Sh SYNOPSIS 24.Lb libproc 25.In libproc.h 26.Sh DESCRIPTION 27The 28.Nm 29library provides consumers a general series of interfaces to inspect 30and control both live processes and core files. 31It is intended for introspection tools such as debuggers by providing a 32high-level interface to the /proc file system 33.Pf ( Xr proc 5 ) . 34.Pp 35The 36.Nm 37library provides interfaces that focus on: 38.Bl -bullet -offset indent 39.It 40Creating and attaching to live process, core files, and arbitrary ELF 41objects. 42.It 43Interrogating the state of a process or core file. 44.It 45Manipulating the current state of a process or thread. 46.It 47Interrogating the state of threads of a process or core file. 48.It 49Running system calls in the context of another process. 50.It 51Various utilities for iterating process and core file file descriptors, 52mappings, symbols, and more. 53.It 54Various utilities to support debugging tools. 55.El 56.Ss Live Processes 57The 58.Nm 59library can be used to manipulate running processes and to create new 60ones. 61To manipulate an existing process first 62.Em grab 63it with the 64.Fn Pgrab 65function. 66A process is generally stopped as a side effect of grabbing it. 67Callers must exercise caution, as if they do not use the library correctly, or 68they terminate unexpectedly, a process may remain stopped. 69.Pp 70Unprivileged users may only grab their own processes. 71Users with the privilege 72.Brq Sy PRIV_PROC_OWNER 73may manipulate processes that they do not own; however, additional 74restrictions as described in 75.Xr privileges 7 76apply. 77.Pp 78In addition, the 79.Fn Pcreate 80and 81.Fn Pxcreate 82functions may be used to create processes which are always controlled by 83the library. 84.Ss Core Files 85The 86.Nm 87library has the ability to open and interpret core files produced by 88processes on the system. 89Process core dump generation is controlled by the 90.Xr coreadm 8 91command. 92In addition, the library has the ability to understand and interpret core dumps 93generated by Linux kernel and can provide a subset of its functionality on such 94core files, provided the original binary is also present. 95.Pp 96Not all functions in the 97.Nm 98library are valid for core files. 99In general, none of the commands which manipulate the current state of a process 100or thread or that try to force system calls on a victim process will work. 101Furthermore several of the information and iteration interfaces are limited 102based on the data that is available in the core file. 103For example, if the core file is of a process that omits the frame pointer, the 104ability to iterate the stack will be limited. 105.Pp 106Use the 107.Fn Pgrab_core 108or 109.Fn Pfgrab_core 110function to open a core file. 111Use the 112.Fn Pgrab_file 113function to open an ELF object file. 114This is useful for obtaining information stored in ELF headers and 115sections. 116.Ss Debug Information 117Many of the operations in the library rely on debug information being 118present in a process and its associated libraries. 119The library leverages symbol table information, CTF data 120.Pq Xr ctf 5 121sections, and frame unwinding information based on the use of an ABI 122defined frame pointer, e\&.g\&. 123.Sy %ebp 124and 125.Sy %rbp 126on x86 systems. 127.Pp 128Some software providers strip programs of this information or build 129their executables such that the information will not be present in a 130core dump. 131To deal with this fact, the library is able to consume information that is not 132present in the core file or the running process. 133It can both consume it from the underlying executable and it also supports 134finding it from related ELF objects that are linked to it via the 135.Sy .gnu_debuglink 136and the 137.Sy .note.gnu.build-id 138ELF sections. 139.Ss Iteration Interfaces 140The 141.Nm 142library provides the ability to iterate over the following aspects of a 143process or core file: 144.Bl -bullet -offset indent 145.It 146Active threads 147.It 148Active and zombie threads 149.It 150All non-system processes 151.It 152All process mappings 153.It 154All objects in a process 155.It 156The environment 157.It 158The symbol table 159.It 160Stack frames 161.It 162File Descriptors 163.El 164.Ss System Call Injection 165The 166.Nm 167library allows the caller to force system calls to be executed in the 168context of the running process. 169This can be used both as a tool for introspection, allowing one to get 170information outside its current context as well as performing modifications to a 171process. 172.Pp 173These functions run in the context of the calling process. 174This is often an easier way of getting non-exported information about a 175process from the system. 176For example, the 177.Xr pfiles 1 178command uses this interface to get more detailed information about a 179process's open file descriptors, which it would not have access to 180otherwise. 181.Sh INTERFACES 182The shared object 183.Sy libproc.so.1 184provides the public interfaces defined below. 185See 186.Xr Intro 3 187for additional information on shared object interfaces. 188Functions are organized into categories that describe their purpose. 189Individual functions are documented in their own manual pages. 190.Ss Creation, Grabbing, and Releasing 191The following routines are related to creating library handles, 192grabbing cores, processes, and threads, and releasing those resources. 193.Bl -column -offset indent ".Sy Pmapping_iter_resolved" ".Sy Psymbol_iter_by_addr" 194.It Sy Lfree Ta Sy Lgrab 195.It Sy Lgrab_error Ta Sy Pcreate 196.It Sy Pcreate_agent Ta Sy Pcreate_callback 197.It Sy Pcreate_error Ta Sy Pdestroy_agent 198.It Sy Pfgrab_core Ta Sy Pfree 199.It Sy Pgrab Ta Sy Pgrab_core 200.It Sy Pgrab_error Ta Sy Pgrab_file 201.It Sy Pgrab_ops Ta Sy Prelease 202.It Sy Preopen Ta Sy Pxcreate 203.El 204.Ss Process interrogation and manipulation 205The following routines obtain information about a process and allow 206manipulation of the process itself. 207.Bl -column -offset indent ".Sy Pmapping_iter_resolved" ".Sy Psymbol_iter_by_addr" 208.It Sy Paddr_to_ctf Ta Sy Paddr_to_loadobj 209.It Sy Paddr_to_map Ta Sy Paddr_to_text_map 210.It Sy Pasfd Ta Sy Pclearfault 211.It Sy Pclearsig Ta Sy Pcontent 212.It Sy Pcred Ta Sy Pctlfd 213.It Sy Pdelbkpt Ta Sy Pdelwapt 214.It Sy Pdstop Ta Sy Pexecname 215.It Sy Pfault Ta Sy Pfgcore 216.It Sy Pgcore Ta Sy Pgetareg 217.It Sy Pgetauxval Ta Sy Pgetauxvec 218.It Sy Pgetenv Ta Sy Pisprocdir 219.It Sy Pissyscall_prev Ta Sy Plmid 220.It Sy Plmid_to_loadobj Ta Sy Plmid_to_map 221.It Sy Plookup_by_addr Ta Sy Plookup_by_name 222.It Sy Pname_to_ctf Ta Sy Pname_to_loadobj 223.It Sy Pname_to_map Ta Sy Pobjname 224.It Sy Pobjname_resolved Ta Sy Pplatform 225.It Sy Ppltdest Ta Sy Ppriv 226.It Sy Ppsinfo Ta Sy Pputareg 227.It Sy Prd_agent Ta Sy Pread 228.It Sy Pread_string Ta Sy Preset_maps 229.It Sy Psetbkpt Ta Sy Psecflags 230.It Sy Psetcred Ta Sy Psetfault 231.It Sy Psetflags Ta Sy Psetpriv 232.It Sy Psetrun Ta Sy Psetsignal 233.It Sy Psetsysentry Ta Sy Psetsysexit 234.It Sy Psetwapt Ta Sy Psetzoneid 235.It Sy Psignal Ta Sy Pstate 236.It Sy Pstatus Ta Sy Pstop 237.It Sy Pstopstatus Ta Sy Psync 238.It Sy Psysentry Ta Sy Psysexit 239.It Sy Puname Ta Sy Pupanic 240.It Sy Pupanic_free Ta Sy Punsetflags 241.It Sy Pupdate_maps Ta Sy Pupdate_syms 242.It Sy Pwait Ta Sy Pwrite 243.It Sy Pxecbkpt Ta Sy Pxecwapt 244.It Sy Pxlookup_by_addr Ta Sy Pxlookup_by_addr_resolved 245.It Sy Pxlookup_by_name Ta Sy Pzonename 246.It Sy Pzonepath Ta Sy Pzoneroot Ta 247.El 248.Ss Thread interrogation and manipulation 249The following routines obtain information about a thread and allow 250manipulation of the thread itself. 251.Bl -column -offset indent ".Sy Pmapping_iter_resolved" ".Sy Psymbol_iter_by_addr" 252.It Sy Lalt_stack Ta Sy Lclearfault 253.It Sy Lclearsig Ta Sy Lctlfd 254.It Sy Ldstop Ta Sy Lgetareg 255.It Sy Lgetfpregs Ta Sy Lgetregs 256.It Sy Lgetxregs Ta Sy Lmain_stack 257.It Sy Lprochandle Ta Sy Lpsinfo 258.It Sy Lputareg Ta Sy Lsetrun 259.It Sy Lsetfpregs Ta Sy Lsetregs 260.It Sy Lsetxregs Ta Sy Lstack 261.It Sy Lstate Ta Sy Lstatus 262.It Sy Lstop Ta Sy Lsync 263.It Sy Lwait Ta Sy Lxecbkpt 264.It Sy Lxecwapt Ta Sy "" 265.El 266.Bl -column -offset indent ".Sy Pmapping_iter_resolved" ".Sy Psymbol_iter_by_addr" 267.It Sy Plwp_alt_stack Ta Sy Plwp_freexregs 268.It Sy Plwp_getfpregs Ta Sy Plwp_getname 269.It Sy Plwp_getpsinfo Ta Sy Plwp_getregs 270.It Sy Plwp_getspymaster Ta Sy Plwp_main_stack 271.It Sy Plwp_getxregs Ta Sy Plwp_setfpregs 272.It Sy Plwp_setregs Ta Sy Plwp_setxregs 273.It Sy Plwp_stack Ta Sy "" 274.El 275.Ss System Call Injection 276The following routines are used to inject specific system calls and have 277them run in the context of a process. 278.Bl -column -offset indent ".Sy Pmapping_iter_resolved" ".Sy Psymbol_iter_by_addr" 279.It Sy pr_access Ta Sy pr_close 280.It Sy pr_creat Ta Sy pr_door_info 281.It Sy pr_exit Ta Sy pr_fcntl 282.It Sy pr_fstat Ta Sy pr_fstat64 283.It Sy pr_fstatvfs Ta Sy pr_getitimer 284.It Sy pr_getpeername Ta Sy pr_getpeerucred 285.It Sy pr_getprojid Ta Sy pr_getrctl 286.It Sy pr_getrlimit Ta Sy pr_getrlimit64 287.It Sy pr_getsockname Ta Sy pr_getsockopt 288.It Sy pr_gettaskid Ta Sy pr_getzoneid 289.It Sy pr_ioctl Ta Sy pr_link 290.It Sy pr_llseek Ta Sy pr_lseek 291.It Sy pr_lstat Ta Sy pr_lstat64 292.It Sy pr_memcntl Ta Sy pr_meminfo 293.It Sy pr_mmap Ta Sy pr_munmap 294.It Sy pr_open Ta Sy pr_processor_bind 295.It Sy pr_rename Ta Sy pr_setitimer 296.It Sy pr_setrctl Ta Sy pr_setrlimit 297.It Sy pr_setrlimit64 Ta Sy pr_settaskid 298.It Sy pr_sigaction Ta Sy pr_stat 299.It Sy pr_stat64 Ta Sy pr_statvfs 300.It Sy pr_unlink Ta Sy pr_waitid 301.El 302.Ss Iteration routines 303These routines are used to iterate over the contents of a process. 304.Bl -column -offset indent ".Sy Pmapping_iter_resolved" ".Sy Psymbol_iter_by_addr" 305.It Sy Penv_iter Ta Sy Plwp_iter 306.It Sy Plwp_iter_all Ta Sy Pmapping_iter 307.It Sy Pmapping_iter_resolved Ta Sy Pobject_iter 308.It Sy Pobject_iter_resolved Ta Sy Pstack_iter 309.It Sy Psymbol_iter Ta Sy Psymbol_iter_by_addr 310.It Sy Psymbol_iter_by_lmid Ta Sy Psymbol_iter_by_name 311.It Sy Pxsymbol_iter Ta Sy Pfdinfo_iter 312.El 313.Ss Utility routines 314The following routines are utilities that are useful to consumers of the 315library. 316.Bl -column -offset indent ".Sy Pmapping_iter_resolved" ".Sy Psymbol_iter_by_addr" 317.It Sy Perror_printf Ta Sy proc_arg_grab 318.It Sy proc_arg_psinfo Ta Sy proc_arg_xgrab 319.It Sy proc_arg_xpsinfo Ta Sy proc_content2str 320.It Sy proc_dmodelname Ta Sy proc_finistdio 321.It Sy proc_fltname Ta Sy proc_fltset2str 322.It Sy proc_flushstdio Ta Sy proc_get_auxv 323.It Sy proc_fdinfo_misc Ta Sy proc_get_cred 324.It Sy proc_get_fdinfo Ta Sy proc_get_lwpsinfo 325.It Sy proc_get_priv Ta Sy proc_get_psinfo 326.It Sy proc_get_status Ta Sy proc_get_initstdio 327.It Sy proc_lwp_in_set Ta Sy proc_lwp_range_valid 328.It Sy proc_signame Ta Sy proc_sigset2str 329.It Sy proc_str2content Ta Sy proc_str2flt 330.It Sy proc_str2fltset Ta Sy proc_str2sig 331.It Sy proc_str2sigset Ta Sy proc_str2sys 332.It Sy proc_str2sysset Ta Sy proc_sysname 333.It Sy proc_sysset2str Ta Sy proc_unctrl_psinfo 334.El 335.Ss x86 Specific Routines 336The following routines are specific to the x86, 32-bit and 64-bit, 337versions of the 338.Nm 339library. 340.Bl -column -offset indent ".Sy Pmapping_iter_resolved" ".Sy Psymbol_iter_by_addr" 341.It Sy Pldt Ta Sy proc_get_ldt 342.El 343.Ss SPARC specific Routines 344The following functions are specific to the SPARC, 32-bit and 64-bit, 345versions of the 346.Nm 347library. 348.Bl -column -offset indent ".Sy Pmapping_iter_resolved" ".Sy Psymbol_iter_by_addr" 349.It Sy Plwp_getgwindows Ta Sy "" 350.El 351.Pp 352The following functions are specific to the 64-bit SPARC version of the 353.Nm 354library. 355.Bl -column -offset indent ".Sy Pmapping_iter_resolved" ".Sy Psymbol_iter_by_addr" 356.It Sy Plwp_getasrs Ta Sy Plwp_setasrs 357.El 358.Sh PROCESS STATES 359Every process handle that exists in 360.Nm 361has a state. 362In some cases, such as for core files, these states are static. 363In other cases, such as handles that correspond to a running process or a 364created process, these states are dynamic and change based on actions taken in 365the library. 366The state can be obtained with the 367.Xr Pstate 3PROC 368function. 369.Pp 370The various states are: 371.Bl -tag -width Dv -offset indent 372.It Dv PS_RUN 373An actively running process. 374This may be a process that was obtained by creating it with functions such as 375.Xr Pcreate 3PROC 376or by grabbing an existing process such as 377.Xr Pgrab 3PROC . 378.It Dv PS_STOP 379An active process that is no longer executing. 380A process may stop for many reasons such as an explicit stop request (through 381.Xr pstop 1 382for example) or if a tracing event is hit. 383.Pp 384The reason a process is stopped may be obtained through the thread's 385.Vt lwpstatus_t 386structure read directly from /proc or obtained through the 387.Xr Lstatus 3PROC 388function. 389.It Dv PS_LOST 390Control over the process has been lost. 391This may happen when the process executes a new image requiring a different set 392of privileges. 393To resume control call 394.Xr Preopen 3PROC . 395For more information on losing control of a process, see 396.Xr proc 5 . 397.It Dv PS_UNDEAD 398A zombie process. 399It has terminated, but it has not been cleaned up yet by its parent. 400For more on the conditions of becoming a zombie, see 401.Xr exec 2 . 402.It Dv PS_DEAD 403Processes in this state are always core files. 404See the earlier section 405.Sx Core Files 406for more information on working with core files. 407.It Dv PS_IDLE 408A process that has never been run. 409This is always the case for handles that refer to files as the files cannot be 410executed. 411Those process handles are obtained through calling 412.Xr Pgrab_file 3PROC . 413.El 414.Pp 415Many functions relating to tracing processes, for example 416.Xr Psignal 3PROC , 417.Xr Psetsignal 3PROC , 418.Xr Psetfault 3PROC , 419.Xr Psysentry 3PROC , 420and others, mention that they only act upon 421.Em Active Processes . 422This specifically refers to processes whose state are in 423.Dv PS_RUN 424and 425.Dv PS_STOP . 426Process handles in the other states have no notion of settable tracing 427flags, though core files 428.Pq type Dv PS_DEAD 429may have a read-only snapshot of their tracing settings available. 430.Sh TYPES 431The 432.Nm 433library uses many types that come from the /proc file system 434.Pq Xr proc 5 435and the ELF format 436.Pq Xr elf 3ELF . 437However, it also defines the following types: 438.Pp 439.Vt struct ps_prochandle 440.Pp 441The 442.Vt struct ps_prochandle 443is an opaque handle to the library and the core element of control for a 444process. 445Consumers obtain pointers to a handle through the use of the 446.Fn Pcreate , 447.Fn Pgrab , 448and related functions. 449When a caller is done with a handle, then it should call one of the 450.Fn Pfree 451and 452.Fn Prelease 453functions to relinquish the handle, release associated resources, and 454potentially set the process to run again. 455.Pp 456.Vt struct ps_lwphandle 457.Pp 458The 459.Vt struct ps_lwphandle 460is analogous to the 461.Vt struct ps_prochandle , 462but it represents the control of an individual thread, rather than a 463process. 464Consumers obtain pointers to a handle through the 465.Fn Lgrab 466function and relinquish it with the 467.Fn Lfree 468function. 469.Pp 470.Vt core_content_t 471.Pp 472The 473.Vt core_content_t 474is a value which describes the various content types of core files. 475These are used in functions such as 476.Xr Pcontent 3PROC 477and 478.Xr Pgcore 3PROC 479to describe and control the types of content that get included. 480Various content types may be included together through a bitwise-inclusive-OR. 481The default system core contents are controlled with the 482.Xr coreadm 8 483tool. 484The following table lists the current set of core contents in the system, though 485the set may increase over time. 486The string after the macro is the human readable string that corresponds with 487the constant and is used by 488.Xr coreadm 8 , 489.Xr proc_content2str 3PROC , 490and 491.Xr proc_str2content 3PROC . 492.Bl -tag -offset indent -width indent 493.It Dv CC_CONTENT_STACK ("stack") 494The contents include the process stack. 495Note, this only covers the main thread's stack. 496The stack of other threads is covered by 497.Dv CC_CONTENT_ANON . 498.It Dv CC_CONTENT_HEAP ("heap") 499The contents include the process heap. 500.It Dv CC_CONTENT_SHFILE ("shfile") 501The contents include shared mappings that are backed by files (e.g. 502mapped through 503.Xr mmap 2 504with the 505.Dv MAP_SHARED 506flag). 507.It Dv CC_CONTENT_SHANNON ("shannon") 508The contents include shared mappings that are backed by anonymous memory 509(e.g. mapped through 510.Xr mmap 2 511with the 512.Dv MAP_SHARED 513and 514.Dv MAP_ANON 515flags). 516.It Dv CC_CONTENT_RODATA ("rodata") 517The contents include private read-only file mappings, such as shared 518library text. 519.It Dv CC_CONTENT_ANON ("anon") 520The contents include private anonymous mappings. 521This includes the stacks of threads which are not the main thread. 522.It Dv CC_CONTENT_SHM ("shm") 523The contents include system V shared memory. 524.It Dv CC_CONTENT_ISM ("ism") 525The contents include ISM (intimate shared memory) mappings. 526.It Dv CC_CONTENT_DISM ("dism") 527The contents include DISM (dynamic shared memory) mappings. 528.It Dv CC_CONTENT_CTF ("ctf") 529The contents include 530.Xr ctf 5 531(Compact C Type Format) information. 532Note, not all objects in the process may have CTF information available. 533.It Dv CC_CONTENT_SYMTAB ("symtab") 534The contents include the symbol table. 535Note, not all objects in the process may have a symbol table available. 536.It Dv CC_CONTENT_ALL ("all") 537This value indicates that all of the above content values are present. 538Note that additional values may be added in the future, in which case 539the value of the symbol will be updated to include them. 540Comparisons with 541.Dv CC_CONTENT_ALL 542should validate all the expected bits are set by an expression such as 543.Li (c & CC_CONTENT_ALL) == CC_CONTENT_ALL . 544.It Dv CC_CONTENT_NONE ("none") 545This value indicates that there is no content present. 546.It Dv CC_CONTENT_DEFAULT ("default") 547The content includes the following set of default values: 548.Dv CC_CONTENT_STACK , 549.Dv CC_CONTENT_HEAP , 550.Dv CC_CONTENT_ISM , 551.Dv CC_CONTENT_DISM , 552.Dv CC_CONTENT_SHM , 553.Dv CC_CONTENT_SHANON , 554.Dv CC_CONTENT_TEXT , 555.Dv CC_CONTENT_DATA , 556.Dv CC_CONTENT_RODATA , 557.Dv CC_CONTENT_ANON , 558.Dv CC_CONTENT_CTF , 559and 560.Dv CC_CONTENT_SYMTAB . 561Note that the default may change. 562Comparisons with CC_CONTENT_DEFAULT should validate that all of the expected 563bits are set with an expression such as 564.Li (c\ &\ CC_CONTENT_DEFAULT)\ ==\ CC_CONTENT_DEFAULT . 565.It Dv CC_CONTENT_INVALID 566This indicates that the contents are invalid. 567.El 568.Pp 569.Vt prfdinfo_t 570.Pp 571The 572.Vt prfdinfo_t 573structure is used with the 574.Fn Pfdinfo_iter , 575.Fn proc_fdwalk , 576.Fn proc_fdinfowalk 577and 578.Fn proc_get_fdinfo 579functions and describes information about a file descriptor. 580The structure is defined as follows: 581.Bd -literal 582typedef struct prfdinfo { 583 int pr_fd; /* file descriptor number */ 584 mode_t pr_mode; /* (see st_mode in stat(2)) */ 585 ino64_t pr_ino; /* inode number */ 586 off64_t pr_size; /* file size */ 587 off64_t pr_offset; /* current offset */ 588 uid_t pr_uid; /* owner's user id */ 589 gid_t pr_gid; /* owner's group id */ 590 major_t pr_major; /* major number of device */ 591 minor_t pr_minor; /* minor number of device */ 592 major_t pr_rmajor; /* major number (if special file) */ 593 minor_t pr_rminor; /* minor number (if special file) */ 594 int pr_fileflags; /* (see F_GETXFL in fcntl(2)) */ 595 int pr_fdflags; /* (see F_GETFD in fcntl(2)) */ 596 short pr_locktype; /* (see F_GETLK in fcntl(2)) */ 597 pid_t pr_lockpid; /* process holding file lock */ 598 int pr_locksysid; /* sysid of locking process */ 599 pid_t pr_peerpid; /* peer process (socket, door) */ 600 int pr_filler[25]; /* reserved for future use */ 601 char pr_peername[PRFNSZ]; /* peer process name */ 602#if __STDC_VERSION__ >= 199901L 603 uint8_t pr_misc[]; /* self describing structures */ 604else 605 uint8_t pr_misc[1]; /* self describing structures */ 606#endif 607} prfdinfo_t; 608.Ed 609.Pp 610The structure has similar information to that found in the 611.Sy stat 612structure that's used as part of the stat family of system calls, 613defined in 614.Xr stat 2 . 615The member 616.Sy pr_fd 617contains the number of the file descriptor of the file. 618The members 619.Fa pr_mode , 620.Fa pr_uid , 621.Fa pr_gid , 622.Fa pr_ino , 623and 624.Fa pr_size 625are the same as the members 626.Fa st_mode , 627.Fa st_uid , 628.Fa st_gid , 629.Fa st_ino , 630and 631.Fa st_size 632in the 633.Fa stat 634structure. 635.Pp 636The 637.Fa pr_major 638and 639.Fa pr_minor 640members contain the major and minor numbers of the device containing the 641directory for this file. 642This is similar to the 643.Fa st_dev 644member of the 645.Vt stat 646structure, except that it is broken out into its major and minor components. 647The 648.Fa pr_rmajor 649and 650.Fa pr_rminor 651members are similar in spirit to 652.Fa pr_major 653and 654.Fa pr_minor ; 655however, they are equivalent to the 656.Fa st_rdev 657member of the 658.Vt stat 659structure and thus have meaning for special character and block files. 660.Pp 661The 662.Fa pr_offset 663member contains the current seek offset of the file descriptor. 664The 665.Fa pr_fileflags 666and 667.Fa pr_fdflags 668members contain the flags that would have been returned by a call to 669.Xr fcntl 2 670with the arguments 671.Dv F_GETXFL 672and 673.Dv F_GETFD 674respectively. 675.Pp 676The 677.Fa pr_locktype , 678.Fa pr_lockpid , 679and 680.Fa pr_locksysid 681contain the information that would have been returned by a call to 682.Xr fcntl 2 683with an argument of 684.Dv F_GETLK . 685.Pp 686The 687.Fa pr_peerpid 688and 689.Fa pr_peername 690members contain the process ID and name of any peer endpoint of a 691connection-oriented socket or stream fd. 692This information is the same as that which would be returned by a call to 693.Xr getpeerucred 3C 694.Pp 695The 696.Fa pr_misc 697member contains miscellaneous additional data relating to the file descriptor. 698The format of these data is described in 699.Xr proc 5 . 700.Pp 701.Vt prsyminfo_t 702.Pp 703The 704.Vt prsyminfo_t 705structure is used with the various symbol look up functions 706.Fn Pxlookup_by_name , 707.Fn Pxlookup_by_addr , 708and 709.Fn Pxlookup_by_addr_resolved 710which describes additional information about a symbol. 711The structure is defined as follows: 712.Bd -literal 713typedef struct prsyminfo { 714 const char *prs_object; /* object name */ 715 const char *prs_name; /* symbol name */ 716 Lmid_t prs_lmid; /* link map id */ 717 uint_t prs_id; /* symbol id */ 718 uint_t prs_table; /* symbol table id */ 719} prsyminfo_t; 720.Ed 721.Pp 722The member 723.Fa prs_object 724points to a string that contains the name of the object file, if known, 725that the symbol comes from. 726The member 727.Fa prs_name 728points to the name of the symbol, if known. 729This may be unknown due to a stripped binary that contains no symbol table. 730The member 731.Fa prs_lmid 732indicates the link map identifier that the symbol was found on. 733For more information on link map identifiers refer to the 734.%B Linker and Libraries Guide 735and 736.Xr dlopen 3C . 737.Pp 738The members 739.Fa prs_id 740and 741.Fa prs_table 742can be used to determine both the symbol table that the entry came from 743and which entry in the table it corresponds to. 744If the value of 745.Fa prs_table 746is 747.Dv PR_SYMTAB 748then it came from the ELF standard symbol table. 749However, if it is instead 750.Dv PR_DYNSYM , 751then that indicates that it comes from the process's dynamic section. 752.Pp 753.Vt proc_lwp_f 754.Pp 755The 756.Vt proc_lwp_f 757is a function pointer type that is used with the 758.Fn Plwp_iter 759function. 760It is defined as 761.Sy typedef 762.Ft int 763.Fo proc_lwp_f 764.Fa "void *" 765.Fa "const lwpstatus_t *" 766.Fc . 767The first argument is a pointer to an argument that the user specifies, 768while the second has the thread's status information and is defined in 769.Xr proc 5 . 770For additional information on using this type, see 771.Xr Plwp_iter 3PROC . 772.Pp 773.Vt proc_lwp_all_f 774.Pp 775The 776.Vt proc_lwp_all_f 777is a function pointer type that is used with the 778.Fn Plwp_iter_all 779function. 780It is defined as 781.Sy typedef 782.Ft int 783.Fo proc_lwp_all_f 784.Fa "void *" 785.Fa "const lwpstatus_t *" 786.Fa "const lwpsinfo_t *" 787.Fc . 788The first argument is a pointer to an argument that the user specifies. 789The second and third arguments contain the thread's status and 790thread-specific 791.Xr ps 1 792information respectively. 793Both structures are defined in 794.Xr proc 5 . 795For additional information on using this type, see 796.Xr Plwp_iter_all 3PROC . 797.Pp 798.Vt proc_fdinfowalk_f 799.Pp 800The 801.Vt proc_fdinfowalk_f 802is a function pointer type that is used with the 803.Fn proc_fdinfowalk 804function to walk the miscellaneous data items contained within a 805.Vt prfdinfo_t 806structure. 807It is defined as 808.Sy typedef 809.Ft int 810.Fo proc_fdinfowalk_f 811.Fa "uint_t" 812.Fa "const void *" 813.Fa "size_t" 814.Fa "void *" 815.Fc . 816The first argument contains the type of the miscellaneous information being 817presented, the second and third provide a pointer to the associated data and 818the length of that data. 819The final argument is a pointer to an argument that the user specifies. 820For more information on using this, see 821.Xr proc_fdinfowalk 3PROC . 822.Pp 823.Vt proc_fdwalk_f 824.Pp 825The 826.Vt proc_fdwalk_f 827is a function pointer type that is used with the 828.Fn proc_fdwalk 829function. 830It is defined as 831.Sy typedef 832.Ft int 833.Fo proc_fdwalk_f 834.Fa "const prfdinfo_t *" 835.Fa "void *" 836.Fc . 837The first argument contains the file descriptor information. 838The 839.Sy prfdinfo_t 840structure is defined in 841.Xr proc 5 . 842The final argument is a pointer to an argument that the user specifies. 843For more information on using this, see 844.Xr proc_fdwalk 3PROC . 845.Pp 846.Vt proc_walk_f 847.Pp 848The 849.Vt proc_walk_f 850is a function pointer type that is used with the 851.Fn proc_walk 852function. 853It is defined as 854.Sy typedef 855.Ft int 856.Fo proc_walk_f 857.Fa "psinfo_t *" 858.Fa "lwpsinfo_t *" 859.Fa "void *" 860.Fc . 861The first argument contains the process 862.Xr ps 1 863information and the second argument contains the representative thread's 864.Xr ps 1 865information. 866Both structures are defined in 867.Xr proc 5 . 868The final argument is a pointer to an argument that the user specifies. 869For more information on using this, see 870.Xr proc_walk 3PROC . 871.Pp 872.Vt proc_map_f 873.Pp 874The 875.Vt proc_map_f 876is a function pointer type that is used with the 877.Fn Pmapping_iter , 878.Fn Pmapping_iter_resolved , 879.Fn Pobject_iter , 880and 881.Fn Pobject_iter_resolved 882functions. 883It is defined as 884.Sy typedef 885.Ft int 886.Fo proc_map_f 887.Fa "void *" 888.Fa "const prmap_t *" 889.Fa "const char *" 890.Fc . 891The first argument is a pointer to an argument that the user specifies. 892The second argument is describes the mapping information and is defined 893in 894.Xr proc 5 . 895The final argument contains the name of the mapping or object file in 896question. 897For additional information on using this type, see 898.Xr Pmapping_iter 3PROC . 899.Pp 900.Vt proc_env_f 901.Pp 902The 903.Vt proc_env_f 904is a function pointer type that is used with the 905.Fn Penv_iter 906function. 907It is defined as 908.Sy typedef 909.Ft int 910.Fo proc_env_f 911.Fa "void *" 912.Fa "struct ps_prochandle *" 913.Fa "uintptr_t" 914.Fa "const char *" 915.Fc . 916The first argument is a pointer to an argument that the user specifies. 917The second argument is a pointer to the 918.Vt struct ps_prochandle 919that the callback was passed to. 920The third argument is the address of the environment variable in the process. 921The fourth argument is the environment variable. 922Values in the environment follow the convention of the form 923.Em variable=value . 924For more information on environment variables see 925.Xr exec 2 926and 927.Xr environ 7 . 928For additional information on using this type, see 929.Xr Penv_iter 3PROC . 930.Pp 931.Vt proc_sym_f 932.Pp 933The 934.Vt proc_sym_f 935is a function pointer type that is used with the 936.Fn Psmbol_iter , 937.Fn Psymbol_iter_by_addr , 938.Fn Psymbol_iter_by_name , 939and 940.Fn Psymbol_iter_by_lmid 941functions. 942It is defined as 943.Sy typedef 944.Ft int 945.Fo proc_sym_f 946.Fa "void *" 947.Fa "const GElf_Sym *" 948.Fa "const char *" 949.Fc . 950The first argument is a pointer to an argument that the user supplies. 951The second argument is a pointer to the ELF symbol information in a 95232-bit and 64-bit neutral form. 953See 954.Xr elf 3ELF 955and 956.Xr gelf 3ELF 957for more information on it. 958The final argument points to a character string that has the name of the symbol. 959For additional information on using this type, see 960.Xr Psymbol_iter 3PROC , 961.Xr Psymbol_iter_by_addr 3PROC , 962.Xr Psymbol_iter_by_name 3PROC , 963and 964.Xr Psymbol_iter_by_lmid 3PROC . 965.Pp 966.Vt proc_xsym_f 967.Pp 968The 969.Vt proc_xsym_f 970is a function pointer type that is used with the 971.Fn Pxsymbol_iter 972function. 973It is defined as 974.Sy typedef 975.Ft int 976.Fo proc_xsym_f 977.Fa "void *" 978.Fa "const GElf_Sym *" 979.Fa "const char *" 980.Fa "const prsyminfo_t *" 981.Fc . 982The first three arguments are identical to those of 983.Vt proc_sym_f . 984The final argument contains additional information about the symbol 985itself. 986The members of the 987.Vt prsyminfo_t 988are defined earlier in this section. 989For additional information on using this type, see 990.Xr Pxsymbol_iter 3PROC . 991.Pp 992.Vt proc_stack_f 993.Pp 994The 995.Vt proc_stack_f 996is a function pointer type that is used with the 997.Fn Pstack_iter 998function. 999It is defined as 1000.Sy typedef 1001.Ft int 1002.Fo proc_stack_f 1003.Fa "void *" 1004.Fa "prgregset_t" 1005.Fa "uint_t" 1006.Fa "const long *" 1007.Fc . 1008The first argument is a pointer to an argument that the user specifies. 1009The second argument's contents are platform specific. 1010The registers that contain stack information, usually the stack pointer and 1011frame pointer, will be filled in to point to an entry. 1012The 1013.Vt prgregset_t 1014is defined in 1015.Xr proc 5 . 1016.Pp 1017The third argument contains the number of arguments to the current stack 1018frame and the fourth argument contains an array of addresses that 1019correspond to the arguments to that stack function. 1020The value of the third argument dictates the number of entries in the fourth 1021argument. 1022For additional information on using this type, see 1023.Xr Pstack_iter 3PROC . 1024.Pp 1025.Vt proc_fdinfo_f 1026.Pp 1027The 1028.Vt proc_fdinfo_f 1029is a function pointer type that is used with the 1030.Fn Pfdinfo_iter 1031function. 1032It is defined as 1033.Sy typedef 1034.Ft int 1035.Fo proc_fdinfo_f 1036.Fa "void *" 1037.Fa "prfdinfo_t *" 1038.Fc . 1039The first argument is a pointer to an argument that the user specifies. 1040The second argument contains information about an open file descriptor. 1041The members of the 1042.Vt prfdinfo_t 1043are defined earlier in this section. 1044For additional information on using this type, see 1045.Xr Pfdinfo_iter 3PROC . 1046.Sh PROGRAMMING NOTES 1047When working with live processes, whether from the 1048.Xr Pgrab 3PROC 1049or 1050.Xr Pcreate 3PROC 1051family of functions, there are some additional considerations. 1052Importantly, if a process calls any of the 1053.Xr exec 2 1054suite of functions, much of the state information that is obtained, 1055particularly that about mappings in the process will be invalid. 1056Callers must ensure that they call 1057.Xr Preset_maps 3PROC 1058when they hold a process handle across an exec. 1059In addition, users of the library should familiarize themselves with the 1060.Sy PROGRAMMING NOTES 1061section of the 1062.Xr proc 5 1063manual page, which discusses issues of privileges and security. 1064.Sh DEBUGGING 1065The library provides a means for obtaining additional debugging 1066information. 1067The output itself is not part of the 1068.Nm 1069library's stable interface. 1070Setting the environment variable 1071.Ev LIBPROC_DEBUG 1072to some value will print information to standard error. 1073For example, 1074.Ev LIBPROC_DEBUG Ns = Ns Em please . 1075.Sh LOCKING 1076Most functions operate on a handle to a process in the form of a 1077.Vt "struct ps_prochandle *" . 1078Unless otherwise indicated, the library does not provide any 1079synchronization for different routines that are operating on the 1080.Sy same 1081.Nm 1082library handle. 1083It is up to the caller to ensure that only a single thread is using a handle at 1084any given time. 1085Multiple threads may call 1086.Nm 1087library routines at the same time as long as each thread is using a 1088different handle. 1089.Pp 1090Each individual function notes its 1091.Sy MT-Level 1092section. 1093The MT-Level of a routine that matches the above description will refer to this 1094manual page. 1095If it does not, then it refers to the standard attributes in 1096.Xr attributes 7 . 1097.Sh INTERFACE STABILITY 1098.Sy Uncommitted 1099.Pp 1100While the library is considered an uncommitted interface, and is still 1101evolving, changes that break compatibility have been uncommon and this 1102trend is expected to continue. 1103It is documented to allow consumers, whether part of illumos or outside of it, 1104to understand the library and make use of it with the understanding that 1105changes may occur which break both source and binary compatibility. 1106.Sh SEE ALSO 1107.Xr gcore 1 , 1108.Xr mdb 1 , 1109.Xr proc 1 , 1110.Xr ps 1 , 1111.Xr exec 2 , 1112.Xr fcntl 2 , 1113.Xr stat 2 , 1114.Xr Intro 3 , 1115.Xr dlopen 3C , 1116.Xr elf 3ELF , 1117.Xr ctf 5 , 1118.Xr proc 5 , 1119.Xr attributes 7 , 1120.Xr environ 7 , 1121.Xr privileges 7 , 1122.Xr coreadm 8 1123.Pp 1124.Rs 1125.%T Linkers and Libraries Guide 1126.Re 1127.Pp 1128.Xr Lfree 3PROC , 1129.Xr Lgrab 3PROC , 1130.Xr Lgrab_error 3PROC , 1131.Xr Pcreate 3PROC , 1132.Xr Pcreate_agent 3PROC , 1133.Xr Pcreate_callback 3PROC , 1134.Xr Pcreate_error 3PROC , 1135.Xr Pdestroy_agent 3PROC , 1136.Xr Pfgrab_core 3PROC , 1137.Xr Pfree 3PROC , 1138.Xr Pgrab 3PROC , 1139.Xr Pgrab_core 3PROC , 1140.Xr Pgrab_error 3PROC , 1141.Xr Pgrab_file 3PROC , 1142.Xr Pgrab_ops 3PROC , 1143.Xr Prelease 3PROC , 1144.Xr Preopen 3PROC , 1145.Xr Pxcreate 3PROC 1146.Pp 1147.Xr Paddr_to_ctf 3PROC , 1148.Xr Paddr_to_loadobj 3PROC , 1149.Xr Paddr_to_map 3PROC , 1150.Xr Paddr_to_text_map 3PROC , 1151.Xr Pasfd 3PROC , 1152.Xr Pclearfault 3PROC , 1153.Xr Pclearsig 3PROC , 1154.Xr Pcontent 3PROC , 1155.Xr Pcred 3PROC , 1156.Xr Pctlfd 3PROC , 1157.Xr Pdelbkpt 3PROC , 1158.Xr Pdelwapt 3PROC , 1159.Xr Pdstop 3PROC , 1160.Xr Pexecname 3PROC , 1161.Xr Pfault 3PROC , 1162.Xr Pfgcore 3PROC , 1163.Xr Pgcore 3PROC , 1164.Xr Pgetareg 3PROC , 1165.Xr Pgetauxval 3PROC , 1166.Xr Pgetauxvec 3PROC , 1167.Xr Pgetenv 3PROC , 1168.Xr Pisprocdir 3PROC , 1169.Xr Pissyscall_prev 3PROC , 1170.Xr Plmid 3PROC , 1171.Xr Plmid_to_loadobj 3PROC , 1172.Xr Plmid_to_map 3PROC , 1173.Xr Plookup_by_addr 3PROC , 1174.Xr Plookup_by_name 3PROC , 1175.Xr Plwp_alt_stack 3PROC , 1176.Xr Plwp_getfpregs 3PROC , 1177.Xr Plwp_getpsinfo 3PROC , 1178.Xr Plwp_getregs 3PROC , 1179.Xr Plwp_getspymaster 3PROC , 1180.Xr Plwp_main_stack 3PROC , 1181.Xr Plwp_setfpregs 3PROC , 1182.Xr Plwp_setregs 3PROC , 1183.Xr Plwp_stack 3PROC , 1184.Xr Pname_to_ctf 3PROC , 1185.Xr Pname_to_loadobj 3PROC , 1186.Xr Pname_to_map 3PROC , 1187.Xr Pobjname 3PROC , 1188.Xr Pobjname_resolved 3PROC , 1189.Xr Pplatform 3PROC , 1190.Xr Ppltdest 3PROC , 1191.Xr Ppriv 3PROC , 1192.Xr Ppsinfo 3PROC , 1193.Xr Pputareg 3PROC , 1194.Xr Prd_agent 3PROC , 1195.Xr Pread 3PROC , 1196.Xr Pread_string 3PROC , 1197.Xr Preset_maps 3PROC , 1198.Xr Psecflags 3PROC , 1199.Xr Psetbkpt 3PROC , 1200.Xr Psetcred 3PROC , 1201.Xr Psetfault 3PROC , 1202.Xr Psetflags 3PROC , 1203.Xr Psetpriv 3PROC , 1204.Xr Psetrun 3PROC , 1205.Xr Psetsignal 3PROC , 1206.Xr Psetsysentry 3PROC , 1207.Xr Psetsysexit 3PROC , 1208.Xr Psetwapt 3PROC , 1209.Xr Psetzoneid 3PROC , 1210.Xr Psignal 3PROC , 1211.Xr Pstate 3PROC , 1212.Xr Pstatus 3PROC , 1213.Xr Pstop 3PROC , 1214.Xr Pstopstatus 3PROC , 1215.Xr Psync 3PROC , 1216.Xr Psysentry 3PROC , 1217.Xr Psysexit 3PROC , 1218.Xr Puname 3PROC , 1219.Xr Pupanic 3PROC , 1220.Xr Pupanic_free 3PROC , 1221.Xr Punsetflags 3PROC , 1222.Xr Pupdate_maps 3PROC , 1223.Xr Pupdate_syms 3PROC , 1224.Xr Pwait 3PROC , 1225.Xr Pwrite 3PROC , 1226.Xr Pxecbkpt 3PROC , 1227.Xr Pxecwapt 3PROC , 1228.Xr Pxlookup_by_addr 3PROC , 1229.Xr Pxlookup_by_addr_resolved 3PROC , 1230.Xr Pxlookup_by_name 3PROC , 1231.Xr Pzonename 3PROC , 1232.Xr Pzonepath 3PROC , 1233.Xr Pzoneroot 3PROC 1234.Pp 1235.Xr Lalt_stack 3PROC , 1236.Xr Lclearfault 3PROC , 1237.Xr Lclearsig 3PROC , 1238.Xr Lctlfd 3PROC , 1239.Xr Ldstop 3PROC , 1240.Xr Lgetareg 3PROC , 1241.Xr Lmain_stack 3PROC , 1242.Xr Lprochandle 3PROC , 1243.Xr Lpsinfo 3PROC , 1244.Xr Lputareg 3PROC , 1245.Xr Lsetrun 3PROC , 1246.Xr Lstack 3PROC , 1247.Xr Lstate 3PROC , 1248.Xr Lstatus 3PROC , 1249.Xr Lstop 3PROC , 1250.Xr Lsync 3PROC , 1251.Xr Lwait 3PROC , 1252.Xr Lxecbkpt 3PROC , 1253.Xr Lxecwapt 3PROC 1254.Pp 1255.Xr pr_access 3PROC , 1256.Xr pr_close 3PROC , 1257.Xr pr_creat 3PROC , 1258.Xr pr_door_info 3PROC , 1259.Xr pr_exit 3PROC , 1260.Xr pr_fcntl 3PROC , 1261.Xr pr_fstat 3PROC , 1262.Xr pr_fstat64 3PROC , 1263.Xr pr_fstatvfs 3PROC , 1264.Xr pr_getitimer 3PROC , 1265.Xr pr_getpeername 3PROC , 1266.Xr pr_getpeerucred 3PROC , 1267.Xr pr_getprojid 3PROC , 1268.Xr pr_getrctl 3PROC , 1269.Xr pr_getrlimit 3PROC , 1270.Xr pr_getrlimit64 3PROC , 1271.Xr pr_getsockname 3PROC , 1272.Xr pr_getsockopt 3PROC , 1273.Xr pr_gettaskid 3PROC , 1274.Xr pr_getzoneid 3PROC , 1275.Xr pr_ioctl 3PROC , 1276.Xr pr_link 3PROC , 1277.Xr pr_llseek 3PROC , 1278.Xr pr_lseek 3PROC , 1279.Xr pr_lstat 3PROC , 1280.Xr pr_lstat64 3PROC , 1281.Xr pr_memcntl 3PROC , 1282.Xr pr_meminfo 3PROC , 1283.Xr pr_mmap 3PROC , 1284.Xr pr_munmap 3PROC , 1285.Xr pr_open 3PROC , 1286.Xr pr_processor_bind 3PROC , 1287.Xr pr_rename 3PROC , 1288.Xr pr_setitimer 3PROC , 1289.Xr pr_setrctl 3PROC , 1290.Xr pr_setrlimit 3PROC , 1291.Xr pr_setrlimit64 3PROC , 1292.Xr pr_settaskid 3PROC , 1293.Xr pr_sigaction 3PROC , 1294.Xr pr_stat 3PROC , 1295.Xr pr_stat64 3PROC , 1296.Xr pr_statvfs 3PROC , 1297.Xr pr_unlink 3PROC , 1298.Xr pr_waitid 3PROC , 1299.Pp 1300.Xr Penv_iter 3PROC , 1301.Xr Plwp_iter 3PROC , 1302.Xr Plwp_iter_all 3PROC , 1303.Xr Pmapping_iter 3PROC , 1304.Xr Pmapping_iter_resolved 3PROC , 1305.Xr Pobject_iter 3PROC , 1306.Xr Pobject_iter_resolved 3PROC , 1307.Xr Pstack_iter 3PROC , 1308.Xr Psymbol_iter 3PROC , 1309.Xr Psymbol_iter_by_addr 3PROC , 1310.Xr Psymbol_iter_by_lmid 3PROC , 1311.Xr Psymbol_iter_by_name 3PROC , 1312.Xr Pxsymbol_iter 3PROC , 1313.Xr Pfdinfo_iter 3PROC 1314.Pp 1315.Xr Perror_printf 3PROC , 1316.Xr proc_arg_grab 3PROC , 1317.Xr proc_arg_psinfo 3PROC , 1318.Xr proc_arg_xgrab 3PROC , 1319.Xr proc_arg_xpsinfo 3PROC , 1320.Xr proc_content2str 3PROC , 1321.Xr proc_dmodelname 3PROC , 1322.Xr proc_finistdio 3PROC , 1323.Xr proc_fltname 3PROC , 1324.Xr proc_fltset2str 3PROC , 1325.Xr proc_flushstdio 3PROC , 1326.Xr proc_get_auxv 3PROC , 1327.Xr proc_get_cred 3PROC , 1328.Xr proc_get_fdinfo 3PROC , 1329.Xr proc_get_priv 3PROC , 1330.Xr proc_get_psinfo 3PROC , 1331.Xr proc_get_status 3PROC , 1332.Xr proc_initstdio 3PROC , 1333.Xr proc_lwp_in_set 3PROC , 1334.Xr proc_lwp_range_valid 3PROC , 1335.Xr proc_signame 3PROC , 1336.Xr proc_sigset2str 3PROC , 1337.Xr proc_str2content 3PROC , 1338.Xr proc_str2flt 3PROC , 1339.Xr proc_str2fltset 3PROC , 1340.Xr proc_str2sig 3PROC , 1341.Xr proc_str2sigset 3PROC , 1342.Xr proc_str2sys 3PROC , 1343.Xr proc_str2sysset 3PROC , 1344.Xr proc_sysname 3PROC , 1345.Xr proc_sysset2str 3PROC , 1346.Xr proc_unctrl_psinfo 3PROC , 1347.Xr proc_fdinfowalk 3PROC , 1348.Xr proc_fdwalk 3PROC , 1349.Xr proc_walk 3PROC 1350.Pp 1351.Xr Pldt 3PROC , 1352.Xr proc_get_ldt 3PROC , 1353.Pp 1354.Xr Plwp_getgwindows 3PROC , 1355.Xr Plwp_getxregs 3PROC , 1356.Xr Plwp_setxregs 3PROC , 1357.Pp 1358.Xr Plwp_getasrs 3PROC , 1359.Xr Plwp_setasrs 3PROC 1360