You are viewing the version of this documentation from Perl blead. This is the main development branch of Perl. (git commit 54b48f4c7a9f49a55e8e0f3b9aeede2f3cf890ff)
$REAL_USER_ID
$UID
$<

The real uid of this process. You can change both the real uid and the effective uid at the same time by using POSIX::setuid(). Since changes to $< require a system call, check $! after a change attempt to detect any possible errors.

Mnemonic: it's the uid you came from, if you're running setuid.