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

FreeBSD Manual Pages

  
 
  

home | help
UNQUOTE(1)		    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
       specified in various ways, is a colon-delimited list of	numbers,  fol-
       lowing  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:

       -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
	       program with a long quoted argument.

       -V      Display	version	 information and exit.	When combined with one
	       or more -v switches, unquote also attempts to display  informa-
	       tion 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			    UNQUOTE(1)

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

home | help