usr/src/man/man3proc/Psetcred.3proc

   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 2015 Joyent, Inc.
  13 .\"
  14 .Dd May 11, 2016
  15 .Dt PSETCRED 3PROC
  16 .Os
  17 .Sh NAME
  18 .Nm Psetcred
  19 .Nd set process credentials
  20 .Sh LIBRARY
  21 .Lb libproc
  22 .Sh SYNOPSIS
  23 .In libproc.h
  24 .Ft int
  25 .Fo Psetcred
  26 .Fa "struct ps_prochandle *P"
  27 .Fa "const prcred_t *credp"
  28 .Fc
  29 .Sh DESCRIPTION
  30 The
  31 .Fn Psetcred
  32 function updates the credentials of the process handle
  33 .Fa P
  34 to the values set in
  35 .Fa credp .
  36 .Fa credp
  37 must be fully initialized.
  38 The definition of the
  39 .Sy prcred_t
  40 structure may be found in
  41 .Xr proc 4 .
  42 .Pp
  43 Note, the credentials may only be updated for an active process.
  44 If the process handle refers to a zombie process, core file, or a file, then
  45 .Fn Psetcred
  46 will fail.
  47 .Sh RETURN VALUES
  48 Upon successful completion, the
  49 .Fn Psetcred
  50 function returns
  51 .Sy 0
  52 and updates the credentials of the process
  53 .Fa P .
  54 Otherwise,
  55 .Sy -1
  56 is returned.
  57 .Sh INTERFACE STABILITY
  58 .Sy Uncommitted
  59 .Sh MT-LEVEL
  60 See
  61 .Sy LOCKING
  62 in
  63 .Xr libproc 3LIB .
  64 .Sh SEE ALSO
  65 .Xr libproc 3LIB ,
  66 .Xr Pcred 3PROC ,
  67 .Xr proc 4