diff options
Diffstat (limited to 'security/nss/tests/doc/nssqa.txt')
-rwxr-xr-x | security/nss/tests/doc/nssqa.txt | 108 |
1 files changed, 0 insertions, 108 deletions
diff --git a/security/nss/tests/doc/nssqa.txt b/security/nss/tests/doc/nssqa.txt deleted file mode 100755 index 34fa0955b..000000000 --- a/security/nss/tests/doc/nssqa.txt +++ /dev/null @@ -1,108 +0,0 @@ -The new QA wrapper consistst mainly of 2 scripts, nssqa and qa_stat, both -include a common header (header) and a common environment (set_environment). -Also used is mksymlinks and path_uniq. - -The scripts that are used on a daily basis are located in /u/sonmi/bin. - -Parameters and Options are the same for both scripts. - -Parameters ----------- - nssversion (supported: 30b, 31, tip) - builddate (default - today, format mmdd) - -Options -------- - -y answer all questions with y - use at your own risk... ignores warnings - -s silent (only usefull with -y) - -h, -? -help you guessed right - displays the usage - -d debug - -f <filename> - write the (error)output to filename - -m <mailinglist> - send filename to mailinglist (csl) only useful - with -f on nssqa - -l <mozroot> run on a local build - does not work at this time - -cron equivalient to -y -s -d -f $RESULTDIR/$HOST.<scriptname> - -nssqa and qa_stat are Beta at the most --------------------------- -Please be aware that - --) machinenames are still hardcoded --FIXED --) other very iPlanet specific environments and features are being used. - --d Debug option will be removed from cron in a few weeks - or maybe not --l QA on local build is not fully implemented yet - -Please do not use on Windows 95 and 98, ME platforms yet. - -use -d if script behaves strange or exits unexpectedly - -How to use QA -------------- -To test a build, first run nssqa on the required QA platforms (some -buildplatforms require QA to be run on additional platforms - for -example Solaris 2.6 has to be tested on 2.8 32 and 64bit) If QA has -been run on multiple or all required platforms it makes sense to run -qa_stat on the output of nssqa as well. -Before used on a new system (even if the same platform has been -tested before) please use completely interactive, to see what the -variables are being initialized to, and read the warnings. Same is -true if being run from a different user account than svbld. - -In any case, if you are using it, please let me know the results. - -Pseudocode Description of nssqa: --------------------------------- -not quite up to date - - header:init (global) - set flags and variables to default values - signal trap (for interupts and kills) - set HOST and DOMSUF variables if running from cron - parse parameters and options - determine os and set up the environment (espec. PATH) - set the directories to run in (influenced by parameters and -l option) - set and initialize the tmp / debugging / output files - - nssqa:init (local) - locking: if nssqa is already running on this systems (yes-exit, - no-lockfile) - set HOST and DOMSUF variables if running interavtively - set flag to kill remaining selfserv processes during cleanup - if QA platform different from build platform create neccessary - symbolic links - wait for the build to finish (max of 5h) - - main: - repeated per test (optimized, debug, 32, 64 bit) - set flags for this run of all.sh (optimized, debug, 32, 64 bit) - set the DIST directory (where the binaries reside) - kill running selfservers (sorry - just don't use the svbld - account if you need to do your own testing... I will fix - selfserv as soon as I can - but it hangs too often and - disturbs all following QA) - run all.sh - - header:exit (global) - remove temporary files - kill remaining selfservers - send email to the list - - - errorhandling - Option / Parameter errors: Exit with usage information - - Severe errors: Exit wit errormessage - example: directory in which all.sh resides does not exist - can't create files or directories - build not done after 5 hours - is already running - - Other errors: User is prompted with the "errormessage - continue (y/n)?" - example: local DIST dir does not exist (continues with next all.sh) - outputdirectory does not exist (user can specify other) - - Signals 2, 3, 15 are treated as severe errors - - - |