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 un-
     quoting  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 con-
	       tents.

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

     -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 in-
	     stead 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  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			      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.1.quarterly>

home | help