Unix/Linux Go Back    

NetBSD 6.1.5 - man page for wordexp (netbsd section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)

WORDEXP(3)			   BSD Library Functions Manual 		       WORDEXP(3)

     wordexp -- perform shell-style word expansions

     Standard C Library (libc, -lc)

     #include <wordexp.h>

     wordexp(const char * restrict words, wordexp_t * restrict pwordexp, int flags);

     wordfree(wordexp_t *pwordexp);

     The wordexp() function performs shell-style word expansion on words and places the list of
     expanded words into the structure pointed to by pwordexp.

     The flags argument is the bitwise inclusive OR of any of the following constants:

     WRDE_APPEND   Append the words to those generated by a previous call to wordexp().

     WRDE_DOOFFS   As many NULL pointers as are specified by the we_offs member of we are added
		   to the front of we_wordv.

     WRDE_NOCMD    Disallow command substitution in words.  See the note in BUGS before using

     WRDE_REUSE    The we argument was passed to a previous successful call to wordexp() but has
		   not been passed to wordfree().  The implementation may reuse the space allo-
		   cated to it.

     WRDE_SHOWERR  Do not redirect shell error messages to /dev/null.

     WRDE_UNDEF    Report error on an attempt to expand an undefined shell variable.

     The structure type wordexp_t includes the following members:

	   size_t  we_wordc
	   char    **we_wordv
	   size_t  we_offs

     The we_wordc member is the count of generated words.

     The we_wordv member points to a list of pointers to expanded words.

     The we_offs member is the number of slots to reserve at the beginning of the we_wordv mem-

     It is the caller's responsibility to allocate the storage pointed to by pwordexp.	The
     wordexp() function allocates other space as needed, including memory pointed to by the
     we_wordv member.

     The wordfree() function frees the memory allocated by wordexp().

     The wordexp() function is implemented as a wrapper around the undocumented wordexp shell
     built-in command.

     The wordexp() function returns zero if successful, otherwise it returns one of the following
     error codes:

     WRDE_BADCHAR  The words argument contains one of the following unquoted characters:
		   <newline>, '|', '&', ';', '<', '>', '(', ')', '{', '}'.

     WRDE_BADVAL   An attempt was made to expand an undefined shell variable and WRDE_UNDEF is
		   set in flags.

     WRDE_CMDSUB   An attempt was made to use command substitution and WRDE_NOCMD is set in

     WRDE_NOSPACE  Not enough memory to store the result.

     WRDE_SYNTAX   Shell syntax error in words.

     WRDE_ERRNO    An internal error occured and errno is set to indicate the error.

     The wordfree() function returns no value.

     IFS  Field separator.

     Invoke the editor on all .c files in the current directory and /etc/motd (error checking

	   wordexp_t we;

	   wordexp("${EDITOR:-vi} *.c /etc/motd", &we, 0);
	   execvp(we->we_wordv[0], we->we_wordv);

     Diagnostic messages from the shell are written to the standard error output if WRDE_SHOWERR
     is set in flags.

     sh(1), fnmatch(3), glob(3), popen(3), system(3)

     The wordexp() and wordfree() functions conform to IEEE Std 1003.1-2001 (``POSIX.1'').  Their
     first release was in IEEE Std 1003.2-1992 (``POSIX.2'').  The return value WRDE_ERRNO is an

     Do not pass untrusted user data to wordexp(), regardless of whether the WRDE_NOCMD flag is
     set.  The wordexp() function attempts to detect input that would cause commands to be exe-
     cuted before passing it to the shell but it does not use the same parser so it may be

BSD					  July 13, 2004 				      BSD
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums

All times are GMT -4. The time now is 10:13 PM.