<box begindoc>**This is automatically generated documentation.**  Edit after the "[[#COMMENTS|COMMENTS]]" heading; changes to the main body will be lost.</box>

====== ChangeUID Element Documentation ======

===== NAME =====

**ChangeUID** -- Click element;
relinquish root privilege

===== SYNOPSIS =====

ChangeUID()

**Ports**: none\\ 
**Drivers**: userlevel\\ 
**Package**: userlevel (core)\\ 

===== DESCRIPTION =====

Sets the current process's effective user and group IDs to its real user and
group IDs, respectively.  This relinquishes any set-uid-root privilege.


===== NOTES =====

ChangeUID's configure phase is set so that it runs immediately after the
"privileged" elements FromDevice.u and ToDevice.u, but before most other
elements.  Thus, this configuration:
     f1 :: FromDevice(eth0) -> ...
     f2 :: FromDump(/tmp/x) -> ...
     ChangeUID()
should fail to initialize if the user cannot read file //%%/%%tmp/x//.  However,
your mileage may vary.  Set-uid-root programs are a bad idea, and Click is no
exception.


Generated by 'click-elem2man' from '../elements/userlevel/changeuid.hh' on 20/Feb/2006.


===== COMMENTS =====