How do I unset a readonly variable in Bash?
$ readonly PI=3.14
$ unset PI
bash: PI: readonly variable
or is it not possible?
Actually, you can unset a readonly variable. but I must warn that this is a hacky method. Adding this answer, only as information, not as a recommendation. Use it at your own risk. Tested on ubuntu 13.04, bash 4.2.45.
This method involves knowing a bit of bash source code & it's inherited from this answer.
$ readonly PI=3.14
$ unset PI
-bash: unset: PI: cannot unset: readonly variable
$ cat << EOF| sudo gdb
attach $$
call unbind_variable("PI")
detach
EOF
$ echo $PI
$
A oneliner answer is to use the batch mode and other commandline flags, as provided in F. Hauri's answer:
$ sudo gdb -ex 'call unbind_variable("PI")' --pid=$$ --batch
sudo
may or may not be needed based on your kernel's ptrace_scope settings. Check the comments on vip9937's answer for more details.
cat << EOF| sudo gdb
to sudo gdb << EOF
. It may not work, since the redirected input provider - bash
is being stopped due to gdb
attachment.
Aug 13, 2014 at 6:46
echo -e "attach $$\n call unbind_variable(\"PI\")\n detach" | gdb
May 1, 2019 at 22:27
I tried the gdb hack above because I want to unset TMOUT (to disable auto-logout), but on the machine that has TMOUT set as read only, I'm not allowed to use sudo. But since I own the bash process, I don't need sudo. However, the syntax didn't quite work with the machine I'm on.
This did work, though (I put it in my .bashrc file):
# Disable the stupid auto-logout
unset TMOUT > /dev/null 2>&1
if [ $? -ne 0 ]; then
gdb <<EOF > /dev/null 2>&1
attach $$
call unbind_variable("TMOUT")
detach
quit
EOF
fi
-q -n
options to silence gdb
an not load any .gdbinit file per safety.
Nov 6, 2014 at 17:55
/proc/sys/kernel/yama/ptrace_scope
. The most common values are 0
, in which case you can do this, and 1
, in which case you probably can't as gdb
is not the direct parent of the bash
process being debugged.
Nov 10, 2017 at 9:00
-q
and -n
are helpful, they (namely -q
) don't silence gdb
, so the /dev/null
redirect is still needed. Great suggestion though, @LucasCimon
Edit 2023-08-29: Full rewrite, make them quicker and satisfy shellcheck
But with simplier syntax:
$ gdb -ex 'call (int) unbind_variable("PI")' --pid=$$ --batch
With some improvement, as a function:
destroy
function:Or How to play with variable meta data.
Note usage of rare bashisms: local -n VARIABLE=$1
, then ${VARIABLE@a}
...
destroy () {
declare -p "$1" &>/dev/null || return 1 # Return if variable does'nt exist,
local -n variable=$1
local resline flags=${variable@a}
local -i result
case $flags in # Run gdb only in case variable is readonly.
*r*) while read -r resline; do
case $resline in
"\$1 = "*) result=" ${resline##*1 = } == 0 ? 0 : 1 ";;
esac
done < <( exec gdb 2>&1 --pid=$$ --batch -ex \
"call (int) unbind_variable(\"$1\")" ) ;;
* ) unset "$1"; result=$? ;;
esac
return $result
}
You could copy this to a bash source file called destroy.bash
, for sample...
1 destroy () { 2 declare -p "$1" &>/dev/null || return 1 # Return if variable does'nt exist, 3 local -n variable=$1 4 local resline flags=${variable@a} 5 local -i result 6 case $flags in # Don't run gdb if variable is not readonly. 7 *r*) while read -r resline; do 8 case $resline in 9 "\$1 = "*) result=" ${resline##*1 = } == 0 ? 0 : 1 ";; 10 esac 11 done < <( exec gdb 2>&1 --pid=$$ --batch -ex \ 12 "call (int) unbind_variable(\"$1\")" ) ;; 13 * ) unset "$1"; result=$? ;; 14 esac 15 return $result 16 }
$flags
,gdb
only if readonly flag is present.
while read ... result= ... done
search for result code of call (int) unbind_variable()
command, from gdb
's output,
gdb
result from 0
to 0
and from others
to 1
,
insteadgdb
with --pid
and --ex
(see at top of this, read man gdb
or gdb --help
),unset
will be used - line 15 return $result
(0
or 1
).$ . destroy.bash
1st with any regular (read-write) variable:
$ declare PI=$(bc -l <<<'4*a(1)')
$ echo $PI
3.14159265358979323844
$ echo ${PI@a} # flags
$ declare -p PI
declare -- PI="3.14159265358979323844"
$ destroy PI
$ echo $?
0
$ declare -p PI
bash: declare: PI: not found
2nd with read only variable:
$ declare -r PI=$(bc -l <<<'4*a(1)')
$ declare -p PI
declare -r PI="3.14159265358979323844"
$ echo ${PI@a} # flags
r
$ unset PI
bash: unset: PI: cannot unset: readonly variable
$ destroy PI
$ echo $?
0
$ declare -p PI
bash: declare: PI: not found
3rd with non existant variable:
$ destroy PI
$ echo $?
1
Under zsh you could simply remove
read-only attribute:
% declare -r PI=3.14
% PI=2
zsh: read-only variable: PI
typeset +r PI
PI=3.141592
echo $PI
3.141592
typeset -r PI
PI=3.1415
zsh: read-only variable: PI
No symbol "unbind_variable" in current context.
. Is this a method a specific bash implementation? I use zsh.
typeset +r PI
, while typeset -r PI
will (re)set read-only attribute
Oct 12 at 9:13
In zsh,
% typeset +r PI
% unset PI
(Yes, I know the question says bash. But when you Google for zsh, you also get a bunch of bash questions.)
Using GDB is terribly slow, or may even be forbidden by system policy (ie can't attach to process.)
Try ctypes.sh instead. It works by using libffi to directly call bash's unbind_variable() instead, which is every bit as fast as using any other bash builtin:
$ readonly PI=3.14
$ unset PI
bash: unset: PI: cannot unset: readonly variable
$ source ctypes.sh
$ dlcall unbind_variable string:PI
$ declare -p PI
bash: declare: PI: not found
First you will need to install ctypes.sh:
$ git clone https://github.com/taviso/ctypes.sh.git
$ cd ctypes.sh
$ ./autogen.sh
$ ./configure
$ make
$ sudo make install
See https://github.com/taviso/ctypes.sh for a full description and docs.
For the curious, yes this lets you call any function within bash, or any function in any library linked to bash, or even any external dynamically-loaded library if you like. Bash is now every bit as dangerous as perl... ;-)
include ctypes.sh
you mean source ctypes.sh
or . ctypes.sh
.
Nov 25, 2018 at 18:10
According to the man page:
unset [-fv] [name ...]
... Read-only variables may not be
unset. ...
If you have not yet exported the variable, you can use exec "$0" "$@"
to restart your shell, of course you will lose all other un-exported variables as well. It seems if you start a new shell without exec
, it loses its read-only property for that shell.
Specifically wrt to the TMOUT variable. Another option if gdb is not available is to copy bash to your home directory and patch the TMOUT string in the binary to something else, for instance XMOUX. And then run this extra layer of shell and you will not be timed out.
$ PI=3.17
$ export PI
$ readonly PI
$ echo $PI
3.17
$ PI=3.14
-bash: PI: readonly variable
$ echo $PI
3.17
What to do now?
$ exec $BASH
$ echo $PI
3.17
$ PI=3.14
$ echo $PI
3.14
$
A subshell can inherit the parent's variables, but won't inherit their protected status.
readonly command makes it final and permanent until the shell process terminates. If you need to change a variable, don't mark it readonly.
TMOUT
?
Apr 3 at 1:33
An alternative if gdb is unavailable: You can use the enable
command to load a custom builtin that will let you unset the read-only attribute. The gist of the code that does it:
SETVARATTR (find_variable ("TMOUT"), att_readonly, 1);
Obviously, you'd replace TMOUT
with the variable you care about.
If you don't want to turn that into a builtin yourself, I forked bash in GitHub and added a fully-written and ready-to-compile loadable builtin called readwrite
. The commit is at https://github.com/josephcsible/bash/commit/bcec716f4ca958e9c55a976050947d2327bcc195. If you want to use it, get the Bash source with my commit, run ./configure && make && make loadables
to build it, then enable -f examples/loadables/readwrite readwrite
to add it to your running session, then readwrite TMOUT
to use it.
No, not in the current shell. If you wish to assign a new value to it, you will have to fork a new shell where it will have a new meaning and will not be considered as read only
.
$ { ( readonly pi=3.14; echo $pi ); pi=400; echo $pi; unset pi; echo [$pi]; }
3.14
400
[]
You can't, from manual page of unset
:
For each name, remove the corresponding variable or function. If no options are supplied, or the -v option is given, each name refers to a shell variable. Read-only variables may not be unset. If -f is specifed, each name refers to a shell function, and the function definition is removed. Each unset variable or function is removed from the environment passed to subsequent commands. If any of RANDOM, SECONDS, LINENO, HISTCMD, FUNCNAME, GROUPS, or DIRSTACK are unset, they lose their special properties, even if they are subsequently reset. The exit status is true unless a name is readonly.
typeset +r VAR
doesn't work since, also according to the man page, Using '+' instead of '-' turns off the attribute instead, with the exception that +a may not be used to destroy an array variable.
Aug 13, 2014 at 19:55
One other way to "unset" a read-only variable in Bash is to declare that variable read-only in a disposable context:
foo(){ declare -r PI=3.14; baz; }
bar(){ local PI=3.14; baz; }
baz(){ PI=3.1415927; echo PI=$PI; }
foo;
bash: PI: readonly variable
bar;
PI=3.1415927
While this is not "unsetting" within scope, which is probably the intent of the original author, this is definitely setting a variable read-only from the point of view of baz() and then later making it read-write from the point of view of baz(), you just need to write your script with some forethought.
Another solution without GDB or an external binary, (in fact an emphasis on Graham Nicholls comment) would be the use of exec
.
In my case there were an annoying read-only variable set in /etc/profile.d/xxx
.
Quoting the bash manual:
"When bash is invoked as an interactive login shell [...] it first reads and executes commands from the file /etc/profile" [...]
When an interactive shell that is not a login shell is started, bash reads and executes commands from /etc/bash.bashrc [...]
The gist of my workaround was to put in my ~/.bash_profile
:
if [ -n "$annoying_variable" ]
then exec env annoying_variable='' /bin/bash
# or: then exec env -i /bin/bash
fi
Warning: to avoid a recursion (which would lock you out if you can only access your account through SSH), one should ensure the "annoying variable" will not be automatically set by the bashrc or to set another variable on the check, for example:
if [ -n "$annoying_variable" ] && [ "${SHLVL:-1}" = 1 ]
then exec env annoying_variable='' SHLVL=$((SHLVL+1)) ${SHELL:-/bin/bash}
fi
$ readonly PI=3.14
$ unset PI
bash: PI: readonly variable
$ gdb --batch-silent --pid=$$ --eval-command='call (int) unbind_variable("PI")'
$ [[ ! -v PI ]] && echo "PI is unset ✔️"
PI is unset ✔️
Notes:
bash 5.0.17
and gdb 10.1
.-v varname
test was added in bash 4.2
. It is "True
if the shell variable varname
is set (has been assigned a value)." – bash reference manualint
. Without that, the following error will result: 'unbind_variable' has unknown return type; cast the call to its declared return type
. The bash source code shows that the return type of the unbind_variable
function is int
.int
to get past the unknown return type
error.if nothing helps, you could go back in time, to a time where readonly vars were not yet implemented:
env ENV=$HOME/.profile /bin/sh
and in $HOME/.profile show some good will and say
export TMOUT=901
This gives you one extra second before you are logged out :-)
readonly TMOUT
. I prefer to comment those lines and to open a new connection to that Linux machine.set -u
, too).