Elements / Control

ChangeUID

relinquish root privilege

SYNOPSIS§

ChangeUID()

Ports: none
Drivers: userlevel

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:8 on 2026/11/02.