home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 March / macformat-022.iso / Shareware City / Utilities / mac-shell-05b / MacShell / MacShell.rsrc / help_18978_find < prev    next >
Encoding:
Text File  |  1994-11-23  |  2.2 KB  |  33 lines
  1. find - Find a file or folder.
  2.  
  3. SYNTAX
  4.    find dirName [-name filename] [-type c] [-ftype TYPE]
  5.          [-fcreator CRTR] [-print] [-exec command ;]
  6.  
  7. DESCRIPTION
  8.  
  9. The command "find" performs a recursive search for files in the directory specified as its first argument.  Each file or directory which meets all conditions imposed by remaining arguments may have its path printed to the standard output, or it may be used as part of another command with the "-exec" option.
  10.  
  11. OPTIONS
  12.  
  13. -name keyword
  14. If the "-name" argument is supplied, only files and directories whose names match the keyword will be found. One or more asterisks (*) may be used as wildcard characters in the keyword.  The asterisk will match any string of characters (including the null string).  If asterisks are used in the keyword, the keyword should be enclosed in double quotes to hide them from MacShell's file name substitution mechanism.
  15.  
  16. -type c
  17. The character c, following the "-type" argument may be either 'f' for file, or 'd' for directory.  If this argument is used, only entities of the specified type will be found.
  18.  
  19. -ftype TYPE
  20. The "-ftype" argument allows files of a particular Macintosh file type signature to be found.  The type signature should be four characters long.  If spaces or asterisks (*) are used in type, the entire string should be quoted.
  21.  
  22. -fcreator CRTR
  23. The "-fcreator" argument allows files with a particular Macintosh file creator signature to be found.  The creator signature should be four characters long.  If spaces or asterisks (*) are used, the entire string should be quoted.
  24.  
  25. -print
  26. If the "-print" argument is found, the path of any files and directories which meet all the given conditions will be printed to the standard output.
  27.  
  28. -exec command \;
  29. Any arguments following the "-exec" option will be used to construct a MacShell command which will be executed once for each file and directory found.  If two brackets are directly juxtapposed, "{}" and form a separate argument following the "-exec" option they will be interpreted as a special "place holder" operator.  Before the command is executed, the file name returned by the "find" command will be substituted for this operator.  The command string must be terminated with ";" or "\;".
  30.  
  31.  
  32.