GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
UNQUOTE(1) FreeBSD General Commands Manual UNQUOTE(1)

unquote
execute a program with safely quoted arguments

unquote [-f fields] [-0 | -N] [-hnpqRVv] fields command [args ...]

The unquote utility executes command with the specified arguments after unquoting the specified fields. The fields argument, which may be specified in various ways, is a colon-delimited list of numbers, following the Unix/C convention that command is argument 0, args starting from 1. Each argument in the list is interpreted as a hex-encoded string, with two hex digits for each character.

The list of arguments to be quoted is constructed in the following way:

  • The environment variable UNQUOTE_ARGS is examined, and if it is set, the string it contains is parsed as a fields list.
  • Any -f arguments are parsed and added to the (possibly empty) list, not replacing any of its contents.
  • The first non-option argument, fields, is examined, and also added to the (possibly empty) list, not replacing any of its contents.

The following options are available:

If -n is also specified, separate arguments in the output with ASCII NUL characters (character code 0). This option cannot be used at the same time as -N.
fields
Specify a list of args to unquote before executing command.
Display a short help message and exit.
If -n is also specified, separate arguments in the output with a newline. This option cannot be used at the same time as -0.
Do not actually execute command, just print out its expanded form.
Do not search the environment variable PATH for the specified command. If this flag is specified, unquote uses execv(3) instead of execvp(3) to execute the command. In other words, command should be a full path to an executable program; PATH is not searched.
Quiet operation; even more quiet when more than one -q flag is specified.
Do the exact opposite of normal operation: quote the arguments instead of unquoting them. Useful when one needs to test a program with a long quoted argument.
Display version information and exit. When combined with one or more -v switches, unquote also attempts to display information about its build environment.
Verbose operation; even more verbose when more than one -v flag is specified.

The following environment variables affect the execution of unquote:

Specify a list of args to unquote before executing command.

None relevant in the present version.

unquote 1 /bin/echo 54657374

Display ‘Test’.

unquote 2 /usr/local/vpopmail/bin/vadduser testuser 255465737424

Add a vpopmail user ‘testuser’ with a password ‘%Test$’.

Should command-line fields and -f arguments override UNQUOTE_ARGS?

Written by Peter Pentchev in 2001.

Peter Pentchev ⟨roam@ringlet.net⟩.
July 7, 2003 FreeBSD

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.