The QEF Quick Reference Card (October, 2005) qvrs −l # list library mapping controls sls −a fname # find

sls −a fname # find and list all files called fname in path
qvrs −XI # list cc −I flags sls −S suffix # find all *.suffix files in source path
User Setup qvrs −VD # output value of @_DestDir_ sls −g t_\* # find files that match t_* in path
• Set $QTREE to Q-Tree directory tree to be used: qvrs −V? # output list of −V and −X short-cuts sls −n fname # find and list file fname but not in cwd
export QTREE=qtree-root (possibly ‘lclqtree‘) libs file # list libraries for ‘sls file‘
• Add $QTREE/bin to your $PATH Configuring Tree’s root.vrs & conf.vrs
rootvrs −d dir # set _DestDir_ libs −a file # list libraries − all forms
export PATH=$QTREE/bin:$PATH incls file # list includes for ‘sls file‘
• Define qd used to chdir using qds: rootvrs −A dir # set RootAlias
rootvrs −c conf # set ConfigName qhy module # output why and how module was last built
eval ‘qfunc qd‘ # add −c if using csh qhy −r module # qhy for module and each of its prereqs
• A useful function to edit a file from the source path: rootvrs −B host # set BuildHost − use . for current host
rootvrs −h sys # name type of build system qsg −M # most common script generator − qsg the qeffile
eds() { $EDITOR $(sls $*) ; } using srclist._ as arguments − usually generated by sls −Ls
• To set up ˜/.qtree directory: rootvrs −H # equivalent to −h ‘system‘
rootvrs −u # update current root.vrs from parent’s root.vrs qsg −c command ... # run qsg command
dirsetup −d $HOME dotqtree qsgdump −S hanoi # view source for qsg hanoi script
• To set up ˜/.qtree directory with alternative name: Note: Can use +Variable=value to set variable
Note: Some settings may result in creation of new qdsrv path. x-qsg −L \*scripts # list qsg scripts
dirsetup −d $HOME −m .qtree=name dotqtree qefdirs −L # show levels for current directory
export HOME_QTREE=$HOME/name Use ‘qdmgt delete −number’ to delete obsolete entry.
qconfset −v V=Val # add/change variable to conf.vrs − use qef −DIto=4 to suppress Installs up to level 4
Documentation qconfset −o Opt # turn on option Opt − use qef −DDoto=8 to suppress builds after level 8
• Manual pages are in $QTREE/man qconfset −n Opt # turn off option Opt qefdirs −ldir # show dir’s level
• qefgui can be used to view man pages and x_db databases cush −d dir −E eset −sVar=Val cmmd ... # run cmmd
• Every Q-Tree program has an −x flag that outputs synopsis, Reduced Qef −x in directory dir, using envset set eset,
one line description, summary of flags and options. qef [−x2cFkMntvX] [−A...] [−d dir] [-[DUGL]...] [−P process] [−f file] setting environment variable $Var to Val
• quete or xdbs can be used to list or query x_db databases [−T {012}] [−m <num>] [args ...]
xdbs will list available x-* databases −x display this explanation Special @ Sequences in Qvrs
−c suppress the @ForbidQef check − use at own risk @@ A literal @
• www.qef.com contains The Guide and other documentation @<newline> Replaced by a space − used to split up long lines
−t suppress the time check − use at own risk
Documentation Conventions −n suppress execution by backend @. Null − used to terminate variable name
• topic(x-dbnm) refers to entry called topic in the x_db −F force execution by backend @# A literal #
database dbnm. To access this topic use: x-dbnm topic −v report all subcommands @NotSet Replaced by @NotSet
• @Variable refers to a qvrs variable. For documentation on −D mac=value set macro to value − see qefdirs @var * Replaced by value of variable var
such a variable use: x-qvrs Variable −L var=value define qvrs value (e.g., −LDEBUGGING) @var[index] * index evaluated before lookup done
Navigating the Forest −P process apply special process − see below @(func ...) * Call to function func − see functions(x-qvrs)
Fields of a qdsrv path records: −d dir chdir to dir @char Replaced by char
Index Project Revision TreeType User Host Config Pathdirs ... −m <num> set maximum parallel processes to <num> * may be followed by ˜ operators − see tildeops(x-qsg)
qds selection flags (i.e., a path-spec): args ... arguments to backend − assigned to @QefArgs See also: syntax(x-qvrs) expansion(x-qvrs) keywords(x-qvrs)
−p project *; −r revision *; −t treetype **; defaults to @_DefaultArgs_ Special @ Sequences in Qsg
−u user *; −h host *; −c config Commonly Used −P Processes @<newline> Replaced by space − used to split up long lines
-num − explicit path number halt halt qefs started from directory (chmod −w %qef*.hlt) @<space> A literal space
* use ‘.’ for current value; automatically applied, if ppscript output macro processed script @<tab> A literal tab
necessary, unless the −a flag is specified. script output script but don’t process it @@ A literal @
** −o == −tobject, −b == −tbaseline, −w == −tworking targets list target descriptions for directory @#... Ignore balance of the line or function arguments
qds −b −pproj # Find the baseline for project proj treewalk walk tree, but do nothing @var * A value of variable var
qds −u. −a # Find all your paths inclswalk walk tree refresning running incls @(name ...) * Call to function name
qds −R # Find the path of the current tree @[Var List ...] * Value of List assigned to Var
qdid −s123 # Bind user’s qdid to a specific path (e.g., 123) Detaching Long Running Processes, etc.
go cmmd # detaches command − merged outputs to ,.g @[/List ...] Global variable named by first element set to
qdid −s # Bind user’s qdid to the current tree balance of list and list returned
qd −i # chdir to current path bound to user’s qdid identifier go −d cmmd # detaches command − merged output to
@{Var} * Replaced by qvrs variable Var
qd −I path-spec # chdir to selected path and ˜/.qtree/goes/<host>/<pid><key>,g @<script ...> * Invokes named script
simultaneously bind user’s qdid to it g # view newest go file − add −d to see go −d output
g −o # view second newest go file * may be followed by ˜ operators − see tildeops(x-qsg)
qd −n # chdir to next (i.e., parent) tree in current @RootPath
qd path-spec subdir # chdir to subdir of selected path; g −num # view numth newest go file See also: qsg-input(x-qsg) qsg-syntax(x-qsg) functions(x-qsg) faq2 faq3
use /subdir to choose directory relative to root g −O # view oldest go file For qefdirs syntax see: qefdirs-input(x-qefdirs)
qdmgt list −P # list current projects in the database g −l # list go files
qdmgt −X # list messages supported by qdsrv g −h # output head of selected go file The Qef Subset of the Q-Tree Tool-Set
adjmat produce adjacency matrix
qdchk # check user’s paths on current host g −t # output tail of selected go file arccentre computes the centre point of a three point arc
qhost host # check access to host and retrieve qtree and home g −q # show current qefs for all gofiles artimes set last modification times for files of an archive
g −Q # show qef termination lines for all gofiles arupdate update an archive according to specified list of members
Setting Up Working and Object Trees g −f # tail −f ,.g ascii print a table of the ASCII character set
qd −pproject −b # chdir to project’s baseline tree g −R # remove go file and show next bfsic build file system integrity check and db maintenance
mkqtree −w working-dir [sub-dirs ...] # create working goes # show go audit trail for current host bp deliver source code boiler plate
tree; use argument ‘.’ to suppress creation of sub-dirs goes −hhost # show go audit trail for specified host c%; cannot use sh command interpreter
qd -pathnum # chdir to new working tree goes −h # show audit trails for all hosts
cancreat check if file can be created
mkqtree −o object-directory # create an object tree cc_g eliminate stupid copyright notices or gratuitous warnings
goes −p # purge completed jobs from current host go audit cc_z eliminate stupid copyright notices or gratuitous warnings
treedirs [sub-dirs ...] # create a tree’s sub-directories − gomonitor # monitors go messages cerrs parse input extracting cc errors and warnings
defaults to all sub-trees. If in object tree, defaults
to those sub-trees in the working directory. Running a Remote Command chkfile
chstat
check all files exist killing argument pid on failure
change the status of files named in list or arguments
qremote cmmd # run command on appropriate @BuildHost
Examining Your Current Configuration qremote −<num> cmmd # run command in path number <num>
cleanilog clean up instal [sic] log file
qvrs # list current qvrs variables clrstr output terminal clear string in readable form
qremote −g ... # go −d the command on the selected host clump convert file:lineno input to ranges
qvrs −f # list current qvrs files qremote −v ... # verbosely report the full command cmdcmp compare the outputs of two commands
qvrs −Pr # output root.vrs qremote −Sservice ... # run on one @_Servers_[service] hosts com compile or process file using embedded command
qvrs −Pc # output conf.vrs commw print input terms not in dictionaries
confvrs # output settings by conf.vrs Sls, Libs, Incls, Qhy, Qsg, Qefdirs ... company output company information
confvrs −d # compare conf.vrs to default sls # list the files in the source path condln link file1 to file2, removing file2 if necessary
qvrs @Variable ... # retrieve value of a qvrs variable sls −c # do it in columns confvrs create or compare qvrs config file
sls fname # find and list 1st file called fname in path contax output selected contax database entries
 conv convert input characters to readable form mnfdel delete releases from manifest database tdbm create TIPs key files
count produce numbers mnfput output a manifest or manifest database tdbrg apply trg program against selected TIPs dbm database entries
cpifdif compare new and old and copy if different necho echo arguments with special character interpretation ted TIPs file editor
ct cut input into cut file numb produce numbered lines termfnd check if termcap/terminfo entry exists
cush cannot use sh command interpreter olex lexical analyser builder termsa list all Ada variables in files
depsmap create file mapping suffixes to mkdeps file p4files list p4 files for the current root termsc list all C variables in files
detox remove toxic waste normally found in dos files p4mnf list p4 files for the current root termsf list all tabbed fields in files
dirlist produce list of all directories for input file list pa output, list, or delete cut files termsw list all words in files
dirname output directory pathname for files parmsdb output parms database in variety of formats tf output name of non-existent comma file
dirsetup extract files and information from a directory setup file pathclash produce list of duplicated executables in path tildes convert between symbolic and real character representations
divide split files at specified pattern pathto map argument file to special directory timeout execute a program with a time limit
dmpdeps dump or test deps object pdirs manipulate a directory stack tlist formated listing of TIPs data base files
dosmap change Unix paths to DOS paths ph output phone numbers for selected contax database entries tmkprof create new TIPs data base profile
double output differing lines of files separated by tab putifdif copy input to ofile if different topolsrt topologically sort input
dry run dhry stone tests qconfset add variable setting to the conf.vrs file touchfiles list or create touch files
elimso eliminate n/troff inclusions qdchk check host’s qdsrv database entries tprof output TIPs profile in various formats
environ list arguments, user info, open files, $vars, and ignored signals qdid assign qdsrv ident and/or bind to path traits output traits table
envset output environment setting commands qdmgt general interface to qef directory server transl translate input fields
envstd list arguments, open files and ignored signals qds output name of directory selected from list of qdsrv paths treedirs mkdir selected or all sub-directories of a qef tree
fcmp compares new and old qdsrv qef directory database server trg template driven TIPs report generator
fdate output formatted date string qdupd add new or update existing path in qdsrv database trgdmp print trg object file
fexists output file names that match specified attributes qed somewhere between a line editor and a command interpreter trgmk compile trg script
ffill fill in suppressed fields qedbufs output qed save file structures tscan interactive TIPs data base scanner
filelist maintain a file list and their collective modification time qef quod erat faciendum - that which was to be done tstrhash test strhash hashing
finclude output file resolving includes qefdirs qef script generator for multiple directories typset interface to typesetter and printing packages
finda find and replace Ada variables qefgui qef graphical interface untouch set file times
findc find and replace C variables qefinfo qef graphical interface upd update conventionally named versions of files
findf find and replace tabbed fields qenv output environment variables in sorted usable form upto print selected lines from named files
findw find and replace words qfunc output selected qfunc function/alias file vcc create, compile, link, and remove version string source file
fixflist remove non-existent files from a file list qgdiff graphical file difference viewer vci version control interface interpreter
flcomm comm(1) like but columns put into files qhost qtree host server vernumcomp compress mkvernum database by removing old entries
fnd find a command qhy report qhy targets were built wcci windows C compiler interface
fndstr find a string in a file and output offset qlex interface to lex whats whats 2 + 2
form text formatter and macro processor qmsdev Microsoft Developer’s Studio project file generator wmode write-protect files
fparens check bracket, brace and double quote balancing in form input qmsg send a message or mail to designated users wordidx output input lines followed by lines indicating word count
ftest test argument file attributes qremote run a command on a remote host wot output sccs id strings
g process go files qrep another grep x-contax contax use and data bases eXplanatory D.B.
go detach a command qsg the qef script generator interpreter x-eml form eml macros eXplanatory D.B.
goes remove completed jobs from go message files qsgcomp compiles a qsg script to object x-form form macros and syntax eXplanatory D.B.
gomonitor display go message files as updated qsgdump dump a qsg object file x-html html qsg library eXplanatory D.B.
gotstr output names of files that contain argument string qsh qef shell command interpreter x-ldeps deps library eXplanatory D.B.
grpsort sort groups of lines specified by ranges qtreeinfo output information about the Q-Tree release x-ldtree dtree library eXplanatory D.B.
hhmmss output a banner of the time quete list x_db topics and quete.db entries that match patterns x-lledit ledit library eXplanatory D.B.
hoff hell of a lot faster than nroff qvrs output qvrs settings x-lqvrs qvrs library eXplanatory D.B.
howto output selected howto information qvrsdmp process qvrs binary file x-ltc tc library eXplanatory D.B.
incls output embedded include dependencies qvrsexpr evaluate and output qvrs expressions x-ltips tips library eXplanatory D.B.
instal meticulously install a file and audit it qyacc interface to yacc x-man the −man macro set eXplanatory D.B.
instdir install a directory r90 reflect lines around diagonal x-qed qed commands and facilities eXplanatory D.B.
instfls install files, but only if necessary, according to script rcslocks report the RCS locked files in a directory x-qef QEF facilities and tools eXplanatory D.B.
jlines join up selected lines realdir output real directory name for argument directory x-qefdirs qefdirs eXplanatory D.B.
josh run jobs selecting from job file recur execute a command repetitively x-qefeg prototype qef files eXplanatory D.B.
kdbm extract data from dbm database rep another grep x-qefgui qef graphical user interface eXplanatory D.B.
l list files in columns resort build new output in order specified by input x-qefpp qef preprocessor controls and macros eXplanatory D.B.
lash long argument list shell interface revl reverse input lines x-qfsic file system integrity (fsic) package eXplanatory D.B.
lc list files by type in columns rls recursive list of files x-qmisc Q-Tree miscellany eXplanatory D.B.
lcmp compare two files rmlist remove files named in input x-qmisc Q-Tree miscellany eXplanatory D.B.
ldbm extract lines from dbm database rmnotnamed remove all files not named by arguments x-qproc software process procedures eXplanatory D.B.
ledmp display current lefile values rmwhite output rpl script to remove redundant white space and newlines x-qsg qsg and its support library eXplanatory D.B.
leset set up line editing keyfile rootvrs create or change root.vrs file x-qvrs qvrs variables, facilities, and files eXplanatory D.B.
liborder process nm of a library to produce dependency graph rotf select fields of input lines for output x-ted ted the TIPs editor eXplanatory D.B.
libs output libs information for named file rpl replace, print, or delete named lines x-trg TIPs trg functions eXplanatory D.B.
lines print first N and last M lines rtabs align output fields by inserting padding x-tscan tscan facilities and commands eXplanatory D.B.
linked list files with multiple links samefile check if two paths refer to same file x-xfig xfig qsg library eXplanatory D.B.
lls ls for input files with selected fields output sdba output statistics about sdbm database x-xppt xppt qsg library eXplanatory D.B.
lninsert replace characters in master by lines from source setbytes set specified offsets to strings x-zr qed function library eXplanatory D.B.
lntree create tree of symbolic links to input file list sfdchk check strfix dictionaries for valid patterns x_db x_db database front end
man3db apply trg script to selected items from man3 TIPs database sfsic source file system integrity check and db maintenance xdbmk create an x_db data base
manprep prepare xdb or manual section for qefgui help display shfix process input file incorporating output of embedded commands xdbs list x_db databases or topics for named databases
mimk issue updating commands according to a dependency script shuffle shuffle input lines and output xfinterp play with the −x flag formatting
mkalltraits run mktraits on remote hosts sls source path ls xtty convert stty(1) output to full explanations
mkddt create ddt declaration snm standardized nm output younger test if files younger than specified time
mkdeps compile incls scanner file srclist check the srclist._ file zfill zero fill digit string
mkerrs process error databases to produce other source strfix replace variables according to replacement dictionary For further information mail to [email protected] or [email protected]
mkopts create options header file sttyek set or display saved stty erase and kill chars of see refcard2 or www.qef.com
mkqtree set up new qef tree subdist create sub-distribution from master filelists
mkquete produce manual section index summarize summarize selected fields
mksolib create shared library externs list sumup output summations of selected input fields
mktraits process traits source to produce binary file suprep suppress repeated fields
mkvernum create or change version string sysnm output system name or check if it matches arguments
mnfadd add a new manifest to manifest database system output system name or check if it matches arguments
mnfchk check manifest database for syntax and consistency tabrpl replace tabs by spaces or vice versa
mnfcmp compare two manifests tchown change ownership and mode according to a template
mnfdb output manifest database release information tdbkeys list TIPs database index keys and/or files