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
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.
12 .\" Copyright 2015 Joyent, Inc.
21 .Nd get zone name, root, and full object path
28 .Fa "struct ps_prochandle *P"
34 .Fa "struct ps_prochandle *P"
40 .Fa "struct ps_prochandle *P"
41 .Fa "const char *path"
48 function attempts to determine the name of the zone for the process
53 including a null terminator, will be written into
58 function attempts to determine the root of the zone corresponding to the
63 including a null terminator, will be written into
65 If the root cannot be found, for example a core file that did not
66 originate on the current system, then the empty string will be written
72 function attempts to derive the full path of the object
74 in a zone relative to the root associated with the current process
79 including a null terminator, will be written into
81 It is legal to use the same buffer for both
85 it will not be updated unless the function completes successfully.
87 Upon successful completion, the
94 Otherwise, if an error occurred,
104 functions will fail if:
108 refers to a core file and zone information was not available in the core
111 refers to an ELF object grabbed through
112 .Xr Pgrab_file 3PROC .
115 refers to an active process and
122 function will fail if:
125 Insufficient memory was available on the system.
127 .Sh INTERFACE STABILITY
135 .Xr getzoneidbyname 3C ,