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