1*43051d27SRobert Mustacchi.\" 2*43051d27SRobert Mustacchi.\" This file and its contents are supplied under the terms of the 3*43051d27SRobert Mustacchi.\" Common Development and Distribution License ("CDDL"), version 1.0. 4*43051d27SRobert Mustacchi.\" You may only use this file in accordance with the terms of version 5*43051d27SRobert Mustacchi.\" 1.0 of the CDDL. 6*43051d27SRobert Mustacchi.\" 7*43051d27SRobert Mustacchi.\" A full copy of the text of the CDDL should have accompanied this 8*43051d27SRobert Mustacchi.\" source. A copy of the CDDL is also available via the Internet at 9*43051d27SRobert Mustacchi.\" http://www.illumos.org/license/CDDL. 10*43051d27SRobert Mustacchi.\" 11*43051d27SRobert Mustacchi.\" 12*43051d27SRobert Mustacchi.\" Copyright 2015 Joyent, Inc. 13*43051d27SRobert Mustacchi.\" 14*43051d27SRobert Mustacchi.Dd May 11, 2016 15*43051d27SRobert Mustacchi.Dt PUNAME 3PROC 16*43051d27SRobert Mustacchi.Os 17*43051d27SRobert Mustacchi.Sh NAME 18*43051d27SRobert Mustacchi.Nm Puname 19*43051d27SRobert Mustacchi.Nd get uname information from a process 20*43051d27SRobert Mustacchi.Sh SYNOPSIS 21*43051d27SRobert Mustacchi.Lb libproc 22*43051d27SRobert Mustacchi.In libproc.h 23*43051d27SRobert Mustacchi.Ft int 24*43051d27SRobert Mustacchi.Fo Puname 25*43051d27SRobert Mustacchi.Fa "struct ps_prochandle *P" 26*43051d27SRobert Mustacchi.Fa "struct utsname *u" 27*43051d27SRobert Mustacchi.Fc 28*43051d27SRobert Mustacchi.Sh DESCRIPTION 29*43051d27SRobert MustacchiThe 30*43051d27SRobert Mustacchi.Fn Puname 31*43051d27SRobert Mustacchifunction copies the operating system information from the process 32*43051d27SRobert Mustacchihandle 33*43051d27SRobert Mustacchi.Fa P 34*43051d27SRobert Mustacchiinto 35*43051d27SRobert Mustacchi.Fa u . 36*43051d27SRobert Mustacchi.Pp 37*43051d27SRobert MustacchiFor an active process or zombie process, this is the same information 38*43051d27SRobert Mustacchiobtained from 39*43051d27SRobert Mustacchi.Xr uname 2 . 40*43051d27SRobert MustacchiFor core files, if available, it is the system information at the time 41*43051d27SRobert Mustacchithe core was dumped. 42*43051d27SRobert Mustacchi.Pp 43*43051d27SRobert MustacchiHandles that correspond to ELF objects do not contain uname 44*43051d27SRobert Mustacchiinformation. 45*43051d27SRobert Mustacchi.Sh RETURN VALUES 46*43051d27SRobert MustacchiUpon successful completion, the 47*43051d27SRobert Mustacchi.Fn Puname 48*43051d27SRobert Mustacchifunction returns 49*43051d27SRobert Mustacchi.Sy 0 50*43051d27SRobert Mustacchiand updates the information at 51*43051d27SRobert Mustacchi.Fa u . 52*43051d27SRobert MustacchiOtherwise, 53*43051d27SRobert Mustacchi.Sy -1 54*43051d27SRobert Mustacchiis returned and 55*43051d27SRobert Mustacchi.Sy errno 56*43051d27SRobert Mustacchiis set to indicate the error. 57*43051d27SRobert Mustacchi.Sh ERRORS 58*43051d27SRobert MustacchiThe 59*43051d27SRobert Mustacchi.Fn Puname 60*43051d27SRobert Mustacchifunction will fail if: 61*43051d27SRobert Mustacchi.Bl -tag -width Er 62*43051d27SRobert Mustacchi.It Er ENODATA 63*43051d27SRobert Mustacchi.Fa P 64*43051d27SRobert Mustacchiis a handle that corresponds to an ELF object or 65*43051d27SRobert Mustacchi.Fa P 66*43051d27SRobert Mustacchiis a handle that corresponds to a core file and that information is not 67*43051d27SRobert Mustacchiavailable in the core file. 68*43051d27SRobert Mustacchi.It Er EFAULT 69*43051d27SRobert Mustacchi.Fa P 70*43051d27SRobert Mustacchiis a handle that corresponds to an active process and 71*43051d27SRobert Mustacchi.Fa u 72*43051d27SRobert Mustacchiis a bad address. 73*43051d27SRobert Mustacchi.El 74*43051d27SRobert Mustacchi.Sh INTERFACE STABILITY 75*43051d27SRobert Mustacchi.Sy Uncommitted 76*43051d27SRobert Mustacchi.Sh MT-LEVEL 77*43051d27SRobert MustacchiSee 78*43051d27SRobert Mustacchi.Sy LOCKING 79*43051d27SRobert Mustacchiin 80*43051d27SRobert Mustacchi.Xr libproc 3LIB . 81*43051d27SRobert Mustacchi.Sh SEE ALSO 82*43051d27SRobert Mustacchi.Xr uname 1 , 83*43051d27SRobert Mustacchi.Xr uname 2 , 84*43051d27SRobert Mustacchi.Xr libproc 3LIB 85