Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
UNQUOTE(1)		FreeBSD	General	Commands Manual		    UNQUOTE(1)

NAME
     unquote --	execute	a program with safely quoted arguments

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

DESCRIPTION
     The unquote utility executes command with the specified arguments after
     unquoting the specified fields.  The fields argument, which may be	speci-
     fied 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:
	   +o   The environment variable	UNQUOTE_ARGS is	examined, and if it is
	       set, the	string it contains is parsed as	a fields list.
	   +o   Any -f arguments	are parsed and added to	the (possibly empty)
	       list, not replacing any of its contents.
	   +o   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:

     -0	     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.

     -f	fields
	     Specify a list of args to unquote before executing	command.

     -h	     Display a short help message and exit.

     -N	     If	-n is also specified, separate arguments in the	output with a
	     newline.  This option cannot be used at the same time as -0.

     -n	     Do	not actually execute command, just print out its expanded
	     form.

     -p	     Do	not search the environment variable PATH for the specified
	     command.  If this flag is specified, unquote uses execv(3)	in-
	     stead of execvp(3)	to execute the command.	 In other words,
	     command should be a full path to an executable program; PATH is
	     not searched.

     -q	     Quiet operation; even more	quiet when more	than one -q flag is
	     specified.

     -R	     Do	the exact opposite of normal operation:	quote the arguments
	     instead of	unquoting them.	 Useful	when one needs to test a pro-
	     gram with a long quoted argument.

     -V	     Display version information and exit.  When combined with one or
	     more -v switches, unquote also attempts to	display	information
	     about its build environment.

     -v	     Verbose operation;	even more verbose when more than one -v	flag
	     is	specified.

ENVIRONMENT
     The following environment variables affect	the execution of unquote:

     UNQUOTE_ARGS  Specify a list of args to unquote before executing command.

FILES
     None relevant in the present version.

EXAMPLES
	   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$'.

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

HISTORY
     Written by	Peter Pentchev in 2001.

AUTHORS
     Peter Pentchev <roam@ringlet.net>.

FreeBSD				 July 7, 2003			       FreeBSD

NAME | SYNOPSIS | DESCRIPTION | ENVIRONMENT | FILES | EXAMPLES | BUGS | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=unquote&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help