Your company here ā€” click to reach over 10,000 unique daily visitors

surfraw-update-path - Man Page

updates PATH in shell config files


surfraw-update-path [-add] [-remove] [-check] [-sys] [-all] [-help] [-shell=SHELL]


surfraw-update-path adds the surfraw elvi directory (/usr/libexec/surfraw) to your PATH in your shell's config file.

Currently it supports bash, sh, csh, tcsh, ash, dash, ksh, pdksh, zsh, rc, and es

Don't forget to login again or source your login files for it to take effect.



Checks to see if the surfraw config code is present. This is the default.


Adds the surfraw config code.


Removes the surfraw config code


Updates the system-wide shell config instead of the user. Must be done as root.


Selects the shell to configure. Defaults to the value of the $SHELL environment variable.

Currently supported shells are:

sh, ash, bash, dash, csh, tcsh, ksh, pdksh, zsh, rc, and es.


Attempts to configure the startup files for all known shells


Gives a usage message

Return Value

-check returns 0 if the surfraw code is present in the file, 1 if it is not found, or 2 on error.

All other options return 0 on success, or 2 on error.



Used to determine which shell to configure, if -shell is not given.


Used to find users config files.


Used by posix-compliant shells to specify a startup rc file.


Used to find user config files for zsh. If not set, defaults to HOME.

See Also

surfraw(1), sh(1), ash(1), bash(1), dash(1), csh(1), tcsh(1), ksh(1), pdksh(1), zsh(1), rc(1), es(1)


Ian Beckwith <ianb@erislabs.net>

Referenced By

elvi.1sr(1), surfraw(1).

2024-01-27 perl v5.38.2 User Contributed Perl Documentation