mirror/zsh
1
0
Fork 0
mirror of git://git.code.sf.net/p/zsh/code synced 2024-11-15 13:34:18 +01:00
Code

33643: elaborate documentation of the PRIVILEGED option

Browse Source
This commit is contained in:
Oliver Kiddle 2014-11-09 17:40:22 +01:00
parent f01188ec2a
commit 31df6c4d32
2 changed files with 19 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
ChangeLog
View File

@ -1,5 +1,8 @@
2014-11-09 Oliver Kiddle <opk@zsh.org>
* 33643: Doc/Zsh/options.yo: elaborate documentation of
the PRIVILEGED option
* 33639: Src/Zle/zle_vi.c, Test/X02zlevi.ztst: fix bug with vi
operators on a blank line and with backward bracket matching

20
Doc/Zsh/options.yo
View File

@ -2195,10 +2195,22 @@ pindex(NOPRIVILEGED)
cindex(privileged mode)
cindex(mode, privileged)
item(tt(PRIVILEGED) (tt(-p), ksh: tt(-p)))(
Turn on privileged mode. This is enabled automatically on startup if the
effective user (group) ID is not equal to the real user (group) ID. Turning
this option off causes the effective user and group IDs to be set to the
real user and group IDs. This option disables sourcing user startup files.
Turn on privileged mode. Typically this is used when script is to be run
with elevated privileges. This should be done as follows directly with
the tt(-p) option to zsh so that it takes effect during startup.
example(#!/bin/zsh -p)
The option is enabled automatically on startup if the effective user
(group) ID is not equal to the real user (group) ID. In this case,
turning the option off causes the effective user and group IDs to be set
to the real user and group IDs. Be aware that if that fails the shell may
be running with different IDs than was intended so a script should check
for failure and act accordingly, for example:
example(unsetopt privileged || exit)
The tt(PRIVILEGED) option disables sourcing user startup files.
If zsh is invoked as `tt(sh)' or `tt(ksh)' with this option set,
tt(/etc/suid_profile) is sourced (after tt(/etc/profile) on interactive
shells). Sourcing tt(~/.profile) is disabled and the contents of the