OS/2 Spezial

home *** CD-ROM | disk | FTP | other *** search

/ OS/2 Spezial / SPEZIAL2_97.zip / SPEZIAL2_97.iso / ANWEND / TOOLS / RUNFOR16 / runfor.doc next >

Wrap

Text File | 1997-04-27 | 21KB | 449 lines

============================================================================ RUNFOR.DOC April 28, 1997 ============================================================================ Ver 1.6 A utility that can run a command for a particular set of files/dirs. This works for OS/2 and DOS commands under various (hopely) command shell. This is a freeware if you don't modify the program. Use this program at your own risk. Please distribute this document together with executables. ---------------------------------------------------------------------------- INTRODUCTION ---------------------------------------------------------------------------- I wrote this program to make jobs easier with more flexible selections of files/dirs and with more flexible handling arguments of a program to be run when I had to repeatedly enter the similar command for each file or dir for a large set of files, especially when a program does not accept wildcards. ---------------------------------------------------------------------------- INSTALLATION ---------------------------------------------------------------------------- Files included in runfor*.zip are runfor.exe - For OS/2 and DOS (require emxrt.zip, or rsx) runfor2.exe - For OS/2 only (require emxrt.zip) runfors.exe - stand-alone OS/2 executable (doesn't need emxrt.zip) runfor.doc - this documentation These programs were compiled by emx/gcc 0.9c and you can get emxrt.zip (EMX runtime package) from the following ftp sites: ftp.uni-stuttgart.de: /pub/systems/os2/emx-0.9c/emxrt.zip hobbes.nmsu.edu: /os2/unix/emx09c/emxrt.zip ftp.cdrom.com: /pub/os2/unix/emx09c/emxrt.zip Refer to documentations of emxrt.zip to install it. [For OS/2 Users] ---------------- After you install emxrt.zip, copy an executable to a directory in your PATH. runfors.exe does not require emxrt.zip, but it is bigger than runfor2.exe. If you decided to use 'runfor2.exe', then you may: copy runfor2.exe f:\bin\runfor.exe where f:\bin is a dir in PATH. You may delete other executables. This completes the installation. [For DOS users] --------------- runfor.exe can run under both platforms of OS/2 and plain DOS with emxrt installed, but OS/2 DOS box or Windows DOS box needs RSX package. You can get RSX runtime package from its home site (ftp.uni-bielefeld.de: /pub/systems/ msdos/misc) or any CTAN sites: ftp.cdrom.com: /pub/tex/ctan/systems/msdos/dpmigcc/rsx510b.zip ftp.cdrom.com: /pub/tex/ctan/systems/msdos/emtex/emxrsx.zip ftp.dante.de: /tex-archive/systems/msdos/emtex/emxrsx.zip After emxrt.zip and rsx501b.zip are installed (emxrsx.zip has both), copy runfor.exe to a PATH. And, add: set EMXOPT=-p in your autoexec.bat to ensure enough free memory, and reboot. That's it. If RunFor could not start some DOS programs or crashes, you may not have enough free memory. You need to enable UMB (Upper Memory Block) and allocate enough memory to your memory manager and load DOS in HMA (High Memory Area) in your CONFIG.SYS. A sample CONFIG.SYS would be DEVICE=C:\WIN3\HIMEM.SYS DEVICE=C:\WIN3\EMM386.EXE RAM frame=none HIGHSCAN x=a000-c7ff DOS=HIGH,UMB RunFor was written for OS/2, and DOS support was not intended. The DOS support is entirely due to emx/gcc's feature of DOS support via emxrt run-time package. RunFor may behave differently or incorrectly under DOS. However, don't blame me. Use at your own risk. [Extra Consideration] ---------------------- If you want to change the default settings of RunFor, you may set 'RUNFOROPT' env variable in your CONFIG.SYS or from a batch cmd file. For example, set RUNFOROPT=-HS (No hidden, no system attrib; same as RUNFOROPT=-H -S) Any options can be set in 'RUNFOROPT' env, but I would not recommend you put options that can't be turned off from the command line. If you keep a few copies of executables of different names, you can keep different default settings via env settings. The rule for env name is that program name (before first '.') in uppercase plus "OPT". For example, if you copied the executable to 'spawn.exe', the program will first look for 'SPAWNOPT' env before searching 'RUNFOROPT'. If 'SPAWNOPT' is found, 'RUNFOROPT' is not searched. If you make another copy named 'doit.exe', you can set 'DOITOPT' env for doit.exe. Of course, if those envs are not found, spawn.exe and doit.exe share 'RUNFOROPT' env setting. ---------------------------------------------------------------------------- USAGE ---------------------------------------------------------------------------- This program is self-explanatory. 'runfor' and 'runfor -?' will display help screens. (Even if you rename the executable file 'runfor.exe' to other name the help screen will correctly display its new program name.) Refer to the help screen. ---------------------------------------------------------------------------- HISTORY ---------------------------------------------------------------------------- Ver 0.x Ver 1.0 January 18, 1996 - first release to public Ver 1.1 January 19, 1996 - Added English month name in date argument of +T or -T. - Very flexible ordering of date parameters. Ver 1.1a January 19, 1996 (not released) - Fixed: outfile could be incorrectly included in target file list. Ver 1.1b March 19, 1996 (not released) - Use PAGER for long help screen Ver 1.2 June 7, 1996 - New option: @<file> target/exclude list in a file. - New option: -t not to look at disk for valid targets. - New macros: %P and %R for path dir without ending '\' or '/'. - New macro prefix modifiers: %l convert to lowercases %u convert to uppercases %x convert to unix style path ('/') (e.g. %xF) - Changed: %l, %u, %x are global options when used before ':'. Ver 1.2a September 17, 1996 (not released) - Bug fix: broken PAGER support in DOS. - Compiled with emx/gcc 0.9c (fixed some minor glitches) Ver 1.3 October 31, 1996 - Enhanced wildcard expansion support (more robust). - Known bug(?): case-ignore in POSIX pattern matching with [...] doesn't work due to emx/gcc 0.9c's fnmatch(). - @<file> now can include quoted names. Ver 1.4 February 28, 1997 - New feature to -w option: Double option (-ww, -w -w) changes current working dir into target dir, which is one level deeper than single option (-w). - New macro prefix modifier: %m for mixed-case conversion. - New +T and -T options for HPFS drives: +Tm -Tm modified time (default; same as +T, -T) +Ta -Ta accessed time +Tc -Tc created time - +/-T options can now take seconds with hh:mm:ss (previously, hh:mm) - Bug fixed: for +/-T options, incorrect selection by wrong timezone computation and incorrect day of week on screen message. - Removed a verbose message of changing dir ("Entering directory:"). Ver 1.5 March 12, 1997 - New options: +B -B ddd[k|kb|m|mb] file selection by minimum/maximum sizes -o- '-' for standard output. -e- '-' to disable macro expansion in env setting. -@ * next argument is a target name (to escape switch symbol) -x@ * next argument is a exclude name (to escape switch symbol) - New macro codes: %T file date and time (with various formats by prefixes) %[m]B file size %ddd positioning at column 'ddd' in expanded string. - Changes and enhancements: -m don't expand macros (just renamed -n of previous version) -x[@] * now supports disk and path in exclude name pattern. %r macro now gives relative path even if target is in other drive. +/-T now accepts two-digit year for the years of 1970-2069. - Bug fixed: Location of output file (-o) when -w was used. Removed output file from target list. Cleaned some minor glitches when no target or -t was given. Ver 1.6 April 28, 1997 - New option: -C dir change the default dir (of runfor) to "dir" before running. (Useful in makefiles) ---------------------------------------------------------------------------- Help Screen (Actual output from 'runfor -?') ---------------------------------------------------------------------------- runfor Ver 1.6 - Run a command - Apr 28 1997, W. Kim Syntax: runfor [options] [targets] [-x exclude_names] : [@]command [args] Options: (can go anywhere before ':') -? Help screen (long) (Add suffix '-' to override PAGER: -?-, -h-) -a Targets are both directories and files -c Confirm before each command execution -C * Change the default dir as if runfor was started from there ("runfor -C foo : prog" is equivalent to "cd foo & prog & cd ..") -d Targets are directories (default targets are files only) -h (same as -?) -i Ignore letter cases in POSIX pattern matching (not work without -p) -m Do not expand macro codes in command + arguments -o {*|-} Output expanded cmd args to a file or stdout(-) without executions -p POSIX pattern matching (affects -x as well); Add -i to ignore case -q[q] Quiet [quieter] mode (place -qq before +T or -T to turn off time log) -Q[#] Quit if a command returns an exit code >= # (-Q = -Q1) -r Recursive run for all subdirs -t Don't look at disk to get target names (i.e. use given names as-is.) -t must be given before any target/exlude names. -u Unix style path name ('/' for directory separators); convert all args. -w[w] Change working dir of command to subdir of target [into target dir] +R -R Only files/dirs with(+) or without(-) READ-ONLY attribute +H -H Only files/dirs with(+) or without(-) HIDDEN attribute +S -S Only files/dirs with(+) or without(-) SYSTEM attribute +A -A Only files/dirs with(+) or without(-) ARCHIVE attribute +B -B ddd[K|KB|M|MB] Files bigger(+B)/smaller(-B) than 'ddd' bytes/KB/MB +T[?][date][;][[hh]:[mm]:[ss]] Files/dirs ON or AFTER the given date/time -T[?][date][;][[hh]:[mm]:[ss]] Files/dirs ON or BEFORE the given date/time [?] can be m (modified; default), a (accessed), or c (created) for HPFS. (On FAT drives, modified time == accessed time == created time.) date = [yy]yy-{mm|mmm}-dd in almost any order. (mm=1-12, mmm=Jan-Dec) Among 3 parts of date, ';', and time, at least one must be given. Valid date strings with numeric month (mm doesn't go after dd) are: [yy]yy-mm-dd, mm-dd, dd, [yy]yy, mm-dd-[yy]yy, [yy]yy-mm, mm-[yy]yy With English month names (mm <= mmm in above), the additional forms are: dd-mmm-[yy]yy, dd-mmm, mmm (very flexible ordering!) Any missing date parameters (yy, mm, dd) are copied from today, and if a time parameter (hh,mm,ss) is missing, it assumes to be zero. (e.g. If this year is 1996, +/-T95 means after/before a year ago.) Year yyyy should be in the range of 1970-2106. However, for small yy, if yy >= 70, yy means the year of 1900+yy; if yy < 70, yy means the year of 2000+yy. %l %u %x Convert all arguments and macros to lower/upper/unix-style path Use macro prefix modifiers to selectively modify macro expansions. targets Target file or dir names (wildcards can be used in target string.) (Note: Any target not found on disk is excluded by default. See -t.) @<file> can be used together to get targets from <file> in which no line can have more than one name. (i.e. one name per line.) @file Read "file" for target names or exclude names (if given after -x). -@ * Next argument is a target name (to escape '-','@','%' switches) (e.g. -@ @abc -@ -foo where "@abc", "-foo" are target names) -e[-] * Set env vars before running; Use double quotes to include a space. Macro codes in env settings are expanded. -e- won't exand them. Env settings are passed to executables, but not to batch commands. -x[@] * Exclude names from target dirs or files. (e.g. -x *.zip d:*\abc\*) -x accepts multiple arguments including @file form as in targets. Use -x@ to escape switch symbol for the next argument: -x@ @foo @bar where "@foo" itself and the names from file "bar" will be excluded. : Command (and its arguments) to be run goes after this separator @ Direct execute without spawning a command shell. '@' makes faster execution, but does not work for .cmd/.bat or I/O redirections. Macro Codes for command + arguments: %% % itself %d drive (e.g. "H:") %p subdir path (e.g. "\src\C\utils\") %P subdir path without ending '\' (e.g. "\src\C\utils") %n file/dir name without extension (e.g. "runfor") %e file/dir extension (e.g. ".doc") %f file/dir name with extension (e.g. "runfor.doc") %F full path name of a file/dir (e.g. "H:\src\C\utils\runfor.doc") %r relative dir from working dir (e.g. "utils\") %R relative dir without ending '\' (e.g. "utils") %T file date & time of last modification (various formats by prefixes) %B file size in bytes (%m prefix converts to K (=1024) or M if too big) %w# (#+1)th wildcard expansion; %w = %w0 (e.g. %w0="for." for run*doc) %(ENV_NAME) Env variable; name is case-sensitive; usually in uppercase. %#[#...] Target counter; %## will be replaced by 2+ digits: 01, 02, ... %ddd[ ] Position at column 'ddd' or add 'ddd' spaces if space followed ('%20X' puts X at column 20 while '%20 X' adds 20 spaces before X) Macro prefix modifiers: (override global %l, %u, %x options) (Syntax: %[modifiers][%]macro_code, e.g. %uxF or %u%x%F) %l convert to lowercases (e.g. %l(PATH)) %m convert to mixedcases (e.g. %mf = "Runfor.doc") %u convert to uppercases (e.g. %uf = "RUNFOR.DOC") %x unix-style path ('/') (e.g. %lxP = %xlP = "/src/c/utils") Note: These modifiers may have different meaning for %T or %B macro codes. Wildcards in POSIX Pattern Matching: ? matches any single character. * matches zero or more occurances of anything. [abc] matches any character of 'a', 'b', or 'c'. [!abc] matches any character except 'a', 'b', and 'c'. [a-z] matches any character from 'a' to 'z'. Description: It executes a command using a command shell given by COMSPEC or SHELL env, or directly executes the command if '@' is in front of the command. If a target name is given with wildcards, it executes a command (that may not accept wildcards) for every matching target file or dir, and its arguments can have macro codes of substitution for drive, dir, name, extension, etc. taken from the matching target file/dir. It can recursively run for subdirs. Environmental Variables: RUNFOROPT Set this env var to change the default behavior of this program from either OS/2 config.sys (DOS autoexec.bat) or a batch file. If the last option in "RUNFOROPT" setting is either -e or -x, then "RUNFOROPT" setting must end with a '-'. For example, set RUNFOROPT=-q -H -S -x *.Z - (note '-' at end) (A shorter setting would be "set RUNFOROPT=-x *.Z -qHS") xxxOPT where "xxx" is the executable name before '.' in uppercases. For example, if you copied this program to "spawn.exe", spawn first searches SPAWNOPT env for its default settings, and then RUNFOROPT is searched only if SPAWNOPT was not found. PAGER Optionally set this env to use a pager (like less or list) for this long help screen. If PAGER is not found, stdout is used. Using Double Quotes: (I/O redirections and blank spaces in names) For I/O redirections, '@' (direct execution) should NOT be used in front of an executable command so as to invoke a command shell that can redirect I/O. To pass redirection symbols (like '>') to the child process (command shell), enclose them (or the whole command string) with matching double quotes. Double quotes are stripped off before passing to child process. To pass a double quote explicitly, use a backslash('\') before double quote. If target names have blank spaces, enclose them with explicit double quotes. Examples: - To take `diff' between all same named files of *.c and *.doc in e: and current dir: runfor *.c *.doc : @diff e:%f %f - To create a batch file "batch.cmd" for later execution: runfor -q -o batch.cmd *.c *.doc : @diff e:%f %f - Find all files >= 1MB from subdirs, which were last modified on or after 97-Mar-01, and save those file names (relative path names) to a file: runfor -o files.lst * +B 1mb +Tmar-01-97 -rq : @%r%f - To list files (date/time, size, name) under subdirs to standard output: runfor -qro- * : @%T %mB %r%f - To run a command after converting its arguments to unix-style path: runfor -u : prog args (TeX is a good example.) - Wildcard macro expansion: To rename "abc*-??.dat" files to "xyz??-*.dat" with confirmation: runfor -c abc*-??.plt : ren %f xyz%w1%w2-%w0.dat - POSIX pattern matching: runfor [a-k]* -x *.z -piqq : echo %f - For files with some attributes: runfor * +HS -A : attrib \"%f\" (Double quotes protect spaces in expanded names for "attrib" command.) - Some examples of arguments for +/-T: (+ or - before T is not shown here) T; T- T: T0 T-;: T0;0 == 00:00:00 of today. T8-12 TAug-12 T12-August == Aug-12 00:00:00 of this year. T95-8-12 T8-12-95 T12-Aug-95 == 1995-Aug-12 00:00:00. T2001-8-12 T01-12-Aug T101-12-Aug == 2001-Aug-12 00:00:00. T8- T-8- TAug == 00:00:00 of today in August of this year. T12 T12; T-12 T--12 == 00:00:00 of the 12th day of this month. T15: T;15 T15:00 == 15:00:00 of today. T95 T1995 T95- T-95 == today 00:00:00 of 1995. "-TAug-12-96 +Ta97-1-1" selects files modified on or before 1996-Aug-12 00:00:00 but accessed on or after 1997-Jan-01 00:00:00 - Selecting files/dirs of attributes is based on `AND' operator. That is, "+HS -RA" means `Hidden=1 AND System=1 AND ReadOnly=0 AND Archive=0'. "-HS" (= -H -S) means files/dirs of not hidden nor system attributes. - Target counter %# (Try these in a dir having more than 10 files): runfor -qq * : echo %#: %f runfor -qq * : echo %##: %f runfor -qq * : echo %###: %f - Env settings: (Usually env names are in uppercase.) runfor -q -e abc=Hello. ABC="There is." : echo %(ABC) %(abc) runfor -q -e ABC="prog.exe can see this env setting." : prog.exe args - Environment variable may contain macro codes to be expanded: runfor -q * -e ABC="File name is %f." : echo %(ABC) (To avoid macro expanding for envs, use "-e-".) - Reading target or exclude list from a file: (@<file>) runfor -tq @file1 -x @file2 : cmd ... (file1 has target names, and file2 has names to be excluded.) (-t is given so that targets in file1 are not searched on disk.) If '@' is part of file/dir name, use -@ or -x@. (-@ @file1 -x@ @file2) - To run "prog" for every file that matches with "blank in file name*" and save the screen outputs (redirection) to a log file "result.log": runfor "blank in file name*" : "prog \"%f\" >> result.log" where \"%f\" is used because the expanded file name(s) have blank spaces (thus explicit double quotes should be used). - Recursive run into subdirs and changing working dirs: The following examples will show the difference between -w and -ww (-w -w). runfor -rqqdww * : cd -- target dirs runfor -rqqdw * : cd -- parent dirs of targets runfor -rqqdw * : (cd %f & cd) Return Codes: (for single input) 0 - Successful Completion 1 - Invalid Command Switch or Argument 2 - Unable to OPEN 3 - Unable to READ 4 - Unable to WRITE 5 - Invalid Data/Format 6 - Invalid Name 7 - Error During Execution 8 - Help screen due to an error -- Wonkoo Kim (wkim+@pitt.edu)