--- torque-2.1.8+dfsg.orig/debian/patches/03-fixhyphens.dpatch +++ torque-2.1.8+dfsg/debian/patches/03-fixhyphens.dpatch @@ -0,0 +1,3001 @@ +#! /bin/sh /usr/share/dpatch/dpatch-run +## fix-hyphens.dpatch by Morten Kjeldgaard +## DP: Fix minus/hyphen problems in the manpages + +@DPATCH@ +diff -urNad torque-2.1.8~/doc/man1/basl2c.1B torque-2.1.8/doc/man1/basl2c.1B +--- torque-2.1.8~/doc/man1/basl2c.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/basl2c.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -109,11 +109,11 @@ + executable. + .Sh OPTIONS + .IP "-d" 5 +-Prints additional debugging messages to the lexer (see -l option), +-parser (see -p option), +-symbol table (see -y option), +-semantic analyzer (see -s option), and +-code generator (see -g option). ++Prints additional debugging messages to the lexer (see \-l option), ++parser (see \-p option), ++symbol table (see \-y option), ++semantic analyzer (see \-s option), and ++code generator (see \-g option). + .IP "-l lexerDebugFile" 5 + .Ar lexerDebugFile + is the name of a file to write into the debugging messages +@@ -291,12 +291,12 @@ + .br + .RS + .IP "Sample constants:" +-5, +1, -3, SUCCESS (=1), FAIL (=0), TRUE (=1), FALSE (=0) ++5, +1, \-3, SUCCESS (=1), FAIL (=0), TRUE (=1), FALSE (=0) + .RE + .IP \f3Float\f1 8 + real numbers which are represented as doubles in the translated C code. + .br +-Sample constants: 4.3, +1.2, -2.6 ++Sample constants: 4.3, +1.2, \-2.6 + .IP \f3Dayofweek\f1 8 + constant values: SUN, MON, TUE, WED, THU, FRI, SAT, internally represented as + integer valued constants with SUN=0, MON=1, and so on. +@@ -343,7 +343,7 @@ + 10mb + 10gb = 10250mb + .fi + .br +-Sample constants: -1b, 2w, 1kb, 2mw, +3gb, 4tw, 6Pb ++Sample constants: \-1b, 2w, 1kb, 2mw, +3gb, 4tw, 6Pb + .IP "\f3Range Int\f1" 8 + .RS + .IP "format: (low Int value, high Int value)" 8 +@@ -502,7 +502,7 @@ + .ft 3 + .nf + lexpr + rexpr (add) +- lexpr - rexpr (subtract) ++ lexpr \- rexpr (subtract) + lexpr * rexpr (multiply) + lexpr / rexpr (divide) + lexpr % rexpr (modulus or remainder) +@@ -526,7 +526,7 @@ + .fi + .ft 1 + .sp +-For -, *, /: ++For \-, *, /: + .sp + .Ty + .nf +@@ -560,7 +560,7 @@ + String str2; + + i1 + i2; +- f1 - i2; ++ f1 \- i2; + sz1 * sz2 * 2b; + sz1 / 1024b; + +@@ -579,17 +579,17 @@ + .sp + .ft 3 + .nf +- +expr // positive - multiplies by 1 an ++ +expr // positive \- multiplies by 1 an + // expression that is + // of Int, Float, or + // Size type + +- -expr // negative - multiplies by -1 an ++ \-expr // negative \- multiplies by \-1 an + // expression that is + // of Int, Float, or + // Size type + +- !expr // not - converts a non-zero expr ++ !expr // not \- converts a non-zero expr + // value into 0, and a + // zero expr value into 1 + // where expr type must be +@@ -603,7 +603,7 @@ + Int i; + + +3; +- -(i + 4); ++ \-(i + 4); + !i; + .fi + .IP c) +@@ -675,7 +675,7 @@ + .ft 3 + .nf + IDENTIFIER++; // identifier=identifier+1 +- IDENTIFIER--; // identifier=identifier-1 ++ IDENTIFIER\-\-; // identifier=identifier-1 + .fi + .sp + .ft 1 +@@ -689,7 +689,7 @@ + Float f; + + i++; +- f--; ++ f\-\-; + .fi + .IP e) + Function call +@@ -740,7 +740,7 @@ + (12:01:00); + (4|4|1997@12:01:00); + "wonderful"; +- -1b; ++ \-1b; + SYNCRUN; + ASYNCRUN; + DELETE; +@@ -1039,7 +1039,7 @@ + print("break on i = 1"); + break; + } +- i--; ++ i\-\-; + } + .fi + .IP "7. switch statement" +@@ -1332,9 +1332,9 @@ + .nf + Operator Associativity + ======================================= ============= +- ! ++ -- + (unary plus) - (unary minus) right ++ ! ++ \-\- + (unary plus) \- (unary minus) right + * / % left +- + - left ++ + \- left + LT LE GT GE left + EQ NEQ left + AND left +@@ -1392,7 +1392,7 @@ + .RS + .IP "Return value:" + SERVER_ACTIVE, SERVER_IDLE, SERVER_SCHED, SERVER_TERM, +-SERVER_TERMDELAY, -1 (unset value) ++SERVER_TERMDELAY, \-1 (unset value) + .RE + .IP "\f3Int ServerMaxRunJobsGet(Server s)\f1" + Returns max_running attribute of Server s. unset value: 0 +@@ -1576,7 +1576,7 @@ + specified are "nodes". It should be specified as + .B nodes=specification + where specification is what a user +-specifies in the -l option argument list for nodes, see qsub (1B). ++specifies in the \-l option argument list for nodes, see qsub (1B). + .br + NOTE: This is a wrapper to the pbs_rescreserve(3B) server function. + .br +@@ -1603,7 +1603,7 @@ + .IP "\f3Int QueTypeGet( Que que )\f1" + Returns queue_type attribute of Que que. + .br +-Return value: QTYPE_E (Execution), QTYPE_R (Routing), -1 (unset value) ++Return value: QTYPE_E (Execution), QTYPE_R (Routing), \-1 (unset value) + .IP "\f3Int QueNumJobsGet( Que que )\f1" + Returns number of jobs residing in Que que. unset value: 0 + .IP "\f3Int QueMaxRunJobsGet( Que que )\f1" +@@ -1615,7 +1615,7 @@ + .IP "\f3Int QuePriorityGet( Que que )\f1" + Returns Priority attribute of Que que. unset value: 0 + .IP "\f3Int QueStateGet( Que que )\f1" +-Returns started attribute of Que que - the job execution selection state of the ++Returns started attribute of Que que \- the job execution selection state of the + que: SCHED_DISABLED, SCHED_ENABLED. unset value: SCHED_DISABLED + .IP "\f3Set Job QueJobsGet( Que que )\f1" + Returns the list of jobs currently residing in que. +@@ -1707,7 +1707,7 @@ + .br + .RS + .IP "Return value:" +-TRANSIT, QUEUED, HELD, WAITING, RUNNING, EXITING, -1 (unset ++TRANSIT, QUEUED, HELD, WAITING, RUNNING, EXITING, \-1 (unset + value) + .RE + .IP "\f3Int JobPriorityGet( Job job )\f1" +@@ -1715,7 +1715,7 @@ + .IP "\f3Int JobRerunFlagGet( Job job )\f1" + Returns Rerunable attribute of Job job. + .br +-Return value: FALSE, TRUE, -1 (unset value) ++Return value: FALSE, TRUE, \-1 (unset value) + .IP "\f3Int JobInteractiveFlagGet( Job job )\f1" + Returns interactive attribute of Job job. + .br +@@ -1901,14 +1901,14 @@ + Returns the name of the vendor for the hardware of the machine (i.e. "sgi", + "ibm"). unset value: NULLSTR + .IP "\f3Int CNodeNumCpusGet(CNode node)\f1" +-Returns the number of processors attached to the node. unset value: -1 ++Returns the number of processors attached to the node. unset value: \-1 + .IP "\f3Size CNodeMemTotalGet( CNode node, String type )\f1" + Returns total memory of + .B type + for the node. + .B type + is an arbitrary string that the scheduler writer defines in the +-scheduler configuration file. unset value: -1b ++scheduler configuration file. unset value: \-1b + .br + Example: + .Ty +@@ -1925,7 +1925,7 @@ + .B type + is an arbitrary string that the scheduler writer defines in the + scheduler configuration file. +-unset value: -1b ++unset value: \-1b + .br + So sample calls will be: + .Ty +@@ -1937,9 +1937,9 @@ + .fi + .IP "\f3Int CNodeIdletimeGet( CNode node )\f1" + Returns number of seconds in which no keystroke or mouse movement has taken +-place on any terminal connected to the node. unset value: -1 ++place on any terminal connected to the node. unset value: \-1 + .IP "\f3Float CNodeLoadAveGet( CNode node )\f1" +-Returns node's load average for all cpus. unset value: -1.0 ++Returns node's load average for all cpus. unset value: \-1.0 + .IP "\f3Int CNodeCpuPercentIdleGet( CNode node )\f1" + Returns the percent of idle time that all the processors of the node have + experienced. +@@ -1958,7 +1958,7 @@ + in bytes/second. + .B type + is defined by the scheduler writer in the scheduler configuration file. +-unset value: -1 ++unset value: \-1 + .br + Some sample calls are: + .Ty +@@ -1972,7 +1972,7 @@ + where + .B name + is the device name arbitrarily defined by the scheduler writer in the +-scheduler configuration file. unset value: -1b ++scheduler configuration file. unset value: \-1b + .br + Example: + .Ty +@@ -1985,7 +1985,7 @@ + where + .B name + is arbitrarily defined by the scheduler writer in the scheduler +-configuration file. unset value: -1b ++configuration file. unset value: \-1b + .br + Example: + .Ty +@@ -1999,7 +1999,7 @@ + .B name + is arbitrarily defined by the scheduler writer in the scheduler + configuration file. +-unset value: -1b ++unset value: \-1b + .br + Example: + .Ty +@@ -2009,7 +2009,7 @@ + .IP "\f3Int CNodeDiskInBwGet( CNode node, String name )\f1" + Returns the write bandwidth (bytes/sec) of the node's disk identified by + .B "name". +-unset value: -1 ++unset value: \-1 + .br + Example: + .Ty +@@ -2019,7 +2019,7 @@ + .IP "\f3Int CNodeDiskOutBwGet( CNode node, String name )\f1" + Returns read bandwidth (bytes/sec) of the node's disk identified by + .B "name". +-unset value: -1 ++unset value: \-1 + .br + Example: + .Ty +@@ -2033,7 +2033,7 @@ + .B name + is arbitrarily defined by the scheduler writer in the scheduler + configuration file. +-unset value: -1b ++unset value: \-1b + .br + Example: + .Ty +@@ -2046,7 +2046,7 @@ + where + .B name + is the device name arbitrarily defined by the scheduler writer in the +-scheduler configuration file. unset value: -1b ++scheduler configuration file. unset value: \-1b + .br + Example: + .Ty +@@ -2065,7 +2065,7 @@ + .IP "\f3Int CNodeSwapOutBwGet( CNode node, String name )\f1" + Returns the swapout rate of the node's swap device identified by + .B name. +-unset value: -1 ++unset value: \-1 + .br + Example: + .Ty +@@ -2079,7 +2079,7 @@ + .B name + is arbitrarily defined by the scheduler writer in the scheduler + configuration file. +-unset value: -1b ++unset value: \-1b + .br + Example: + .Ty +@@ -2093,7 +2093,7 @@ + .B name + is arbitrarily defined by the scheduler writer in the scheduler + configuration file. +-unset value: -1b ++unset value: \-1b + .br + Example: + .nf +@@ -2102,7 +2102,7 @@ + .IP "\f3Int CNodeTapeInBwGet( CNode node, String name )\f1" + Returns the write bandwidth (bytes/sec) of the node's tape identified by + .B "name". +-unset value: -1 ++unset value: \-1 + .br + Example: + .Ty +@@ -2112,7 +2112,7 @@ + .IP "\f3Int CNodeTapeOutBwGet( CNode node, String name )\f1" + Returns the read bandwidth (bytes/sec) of the node's tape identified by + .B "name". +-unset value: -1 ++unset value: \-1 + .br + Example: + .Ty +@@ -2126,7 +2126,7 @@ + .B name + is arbitrarily defined by the scheduler writer in the scheduler configuration + file. +-unset value: -1b ++unset value: \-1b + .br + Example: + .Ty +@@ -2140,7 +2140,7 @@ + .B name + is arbitrarily defined by the scheduler writer in some configuration + file. +-unset value: -1b ++unset value: \-1b + .br + Example: + .Ty +@@ -2155,7 +2155,7 @@ + .B name + is arbitrarily defined by the scheduler writer in + the scheduler configuration file. +-unset value: -1b ++unset value: \-1b + .br + Example: + .Ty +@@ -2165,7 +2165,7 @@ + .IP "\f3Int CNodeSrfsInBwGet( CNode node, String name )\f1" + Returns the write bandwidth (bytes/sec) of the node's srfs device identified by + .B "name". +-unset value: -1 ++unset value: \-1 + .br + Example: + .nf +@@ -2174,7 +2174,7 @@ + .IP "\f3Int CNodeSrfsOutBwGet( CNode node, String name )\f1" + Returns the read bandwidth (bytes/sec) of the node's srfs device identified by + .B "name". +-unset value: -1 ++unset value: \-1 + .br + Example: + .nf +@@ -2186,7 +2186,7 @@ + .IP "\f3DateTime datetimeGet()\f1" + gets the current date/time. + .IP "\f3Int datetimeToSecs(DateTime dt)\f1" +-returns the # of seconds since epoch (beginning of UNIX time - 00:00:00, ++returns the # of seconds since epoch (beginning of UNIX time \- 00:00:00, + January 1, 1970) for the given date/time + .B dt. + .IP "\f3Int JobAction( Job job, Int action, String param )\f1" +@@ -2232,7 +2232,7 @@ + DELETE deletes the job. + Param value: + "deldelay=<# of secs>" +- - delay # of seconds ++ \- delay # of seconds + between the sending + of SIGTERM and SIGKILL + to the job before +@@ -2249,7 +2249,7 @@ + Param value: + "u", "o", "s", "uo", "os", + "uos" +- - type of holds to place ++ \- type of holds to place + on job: u(ser), o(ther), + s(ystem). + +@@ -2258,7 +2258,7 @@ + Param value: + "u", "o", "s", "uo", "os", + "uos" +- - type of holds to remove ++ \- type of holds to remove + from job: u(ser), o(ther), + s(ystem). + +@@ -2787,7 +2787,7 @@ + .Ty CNodeLoadAveGet(node) + will return the value obtained from some query (this + could be the string "loadave") as sent to the node's MOM. +-The " -> CNode..Get()" mappings are established ++The " \-> CNode..Get()" mappings are established + internally, but they can be modified or more mappings can be added via the + scheduler configuration file. The config file is discussed in + .B pbs_sched_basl(8B). +diff -urNad torque-2.1.8~/doc/man1/nqs2pbs.1B torque-2.1.8/doc/man1/nqs2pbs.1B +--- torque-2.1.8~/doc/man1/nqs2pbs.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/nqs2pbs.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -113,15 +113,15 @@ + specifications of "today", "tomorrow", or the name of the days of the week + such as "Monday". If any of these are encountered in a script, the PBS + specification will contain only the time portion of the NQS specification, +-i.e. #PBS -a hhmm[.ss]. It is suggested that you specify the execution ++i.e. #PBS \-a hhmm[.ss]. It is suggested that you specify the execution + time on the qsub command line rather than in the script. + .LP + Note that PBS will interpret a time specification without a date in the + following way: +-.IP - 3 ++.IP \- 3 + If the time specified has not yet been reached, the job will become eligible + to run at that time today. +-.IP - ++.IP \- + If the specified time has already passed when the job is submitted, the job + will become eligible to run at that time tomorrow. + .LP +diff -urNad torque-2.1.8~/doc/man1/pbs.1B torque-2.1.8/doc/man1/pbs.1B +--- torque-2.1.8~/doc/man1/pbs.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Iq + .Sh NAME +-pbs - general information on pbs ++pbs \- general information on pbs + .Sh DESCRIPTION + PBS stands for + .I "Portable Batch System." +@@ -141,7 +141,7 @@ + command. Two forms of output are available with the qstat command. + The default form is the short display. Information about a job + is limited to a single line. Complete information about the job or +-jobs is available through qstat with the -f option. ++jobs is available through qstat with the \-f option. + Information will be given about all jobs in the system, all jobs in specified + queues, or only specified jobs. + .LP +diff -urNad torque-2.1.8~/doc/man1/pbs_job_attributes.7B torque-2.1.8/doc/man1/pbs_job_attributes.7B +--- torque-2.1.8~/doc/man1/pbs_job_attributes.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_job_attributes.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .TH pbs_job_attributes 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_job_attributes - pbs job attributes ++pbs_job_attributes \- pbs job attributes + .SH DESCRIPTION + .Iq + .if !\n(Pb .ig Ig +diff -urNad torque-2.1.8~/doc/man1/pbs_queue_attributes.7B torque-2.1.8/doc/man1/pbs_queue_attributes.7B +--- torque-2.1.8~/doc/man1/pbs_queue_attributes.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_queue_attributes.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .TH pbs_queue_attributes 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_queue_attributes - pbs queue attributes ++pbs_queue_attributes \- pbs queue attributes + .SH DESCRIPTION + .Iq + .if !\n(Pb .ig Ig +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_aix4.7B torque-2.1.8/doc/man1/pbs_resources_aix4.7B +--- torque-2.1.8~/doc/man1/pbs_resources_aix4.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_aix4.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_aix4 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_aix4 - pbs Resources on IBM AIX 4 ++pbs_resources_aix4 \- pbs Resources on IBM AIX 4 + .SH DESCRIPTION + This page summarizes the resources supported by PBS for IBM systems running + AIX version 4. + These resources are specified for jobs by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .SH RESOURCES + .Iq +@@ -124,13 +124,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_aix5.7B torque-2.1.8/doc/man1/pbs_resources_aix5.7B +--- torque-2.1.8~/doc/man1/pbs_resources_aix5.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_aix5.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_aix5 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_aix5 - pbs Resources on IBM AIX 5 ++pbs_resources_aix5 \- pbs Resources on IBM AIX 5 + .SH DESCRIPTION + This page summarizes the resources supported by PBS for IBM systems running + AIX version 5. + These resources are specified for jobs by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .SH RESOURCES + .Iq +@@ -124,13 +124,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_darwin.7B torque-2.1.8/doc/man1/pbs_resources_darwin.7B +--- torque-2.1.8~/doc/man1/pbs_resources_darwin.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_darwin.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_darwin 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_darwin - pbs resources on Darwin ++pbs_resources_darwin \- pbs resources on Darwin + .SH DESCRIPTION + This page summarizes the resources supported by PBS for PC workstations + running Darwin. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .LP + .SH RESOURCES +@@ -122,13 +122,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_digitalunix.7B torque-2.1.8/doc/man1/pbs_resources_digitalunix.7B +--- torque-2.1.8~/doc/man1/pbs_resources_digitalunix.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_digitalunix.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_digitalunix 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_digitalunix - pbs resources on DEC Unix ++pbs_resources_digitalunix \- pbs resources on DEC Unix + .SH DESCRIPTION + This page summarizes the resources supported by PBS for DEC systems + running Digital Unix 5. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .LP + .SH RESOURCES +@@ -118,13 +118,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_freebsd.7B torque-2.1.8/doc/man1/pbs_resources_freebsd.7B +--- torque-2.1.8~/doc/man1/pbs_resources_freebsd.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_freebsd.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_Resources_freebsd 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_freebsd - pbs resources on FreeBSD ++pbs_resources_freebsd \- pbs resources on FreeBSD + .SH DESCRIPTION + This page summarizes the resources supported by PBS for AMD/Intel/Cyrix + workstations running FreeBSD. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .SH RESOURCES + .Iq +@@ -121,13 +121,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15 ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15 + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_freebsd5.7B torque-2.1.8/doc/man1/pbs_resources_freebsd5.7B +--- torque-2.1.8~/doc/man1/pbs_resources_freebsd5.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_freebsd5.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_Resources_freebsd5 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_freebsd5 - pbs resources on FreeBSD 5.x and 6.x ++pbs_resources_freebsd5 \- pbs resources on FreeBSD 5.x and 6.x + .SH DESCRIPTION + This page summarizes the resources supported by PBS for AMD/Intel/Cyrix + workstations running FreeBSD. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .SH RESOURCES + .Iq +@@ -121,13 +121,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15 ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15 + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_fujitsu.7B torque-2.1.8/doc/man1/pbs_resources_fujitsu.7B +--- torque-2.1.8~/doc/man1/pbs_resources_fujitsu.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_fujitsu.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_fujitsu 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_fujitsu - pbs resources on Fujitsu UXP/V ++pbs_resources_fujitsu \- pbs resources on Fujitsu UXP/V + .SH DESCRIPTION + This page summarizes the resources supported by PBS for Fujitsu + computers running UXP/V. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .LP + .SH RESOURCES +@@ -118,13 +118,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_hpux10.7B torque-2.1.8/doc/man1/pbs_resources_hpux10.7B +--- torque-2.1.8~/doc/man1/pbs_resources_hpux10.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_hpux10.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_hpux10 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_hpux10 - pbs resources on HP UX ++pbs_resources_hpux10 \- pbs resources on HP UX + .SH DESCRIPTION + This page summarizes the resources supported by PBS for systems + running HP UX version 10.x. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .LP + .SH RESOURCES +@@ -118,13 +118,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_hpux11.7B torque-2.1.8/doc/man1/pbs_resources_hpux11.7B +--- torque-2.1.8~/doc/man1/pbs_resources_hpux11.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_hpux11.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_hpux11 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_hpux11 - pbs resources on HP UX ++pbs_resources_hpux11 \- pbs resources on HP UX + .SH DESCRIPTION + This page summarizes the resources supported by PBS for systems + running HP UX version 11.x. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .LP + .SH RESOURCES +@@ -118,13 +118,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_irix5.7B torque-2.1.8/doc/man1/pbs_resources_irix5.7B +--- torque-2.1.8~/doc/man1/pbs_resources_irix5.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_irix5.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_irix 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_irix - pbs resources on SGI Irix ++pbs_resources_irix \- pbs resources on SGI Irix + .SH DESCRIPTION + This page summarizes the resources supported by PBS for SGI workstations + running IRIX 5. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .LP + .SH RESOURCES +@@ -122,13 +122,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_irix6.7B torque-2.1.8/doc/man1/pbs_resources_irix6.7B +--- torque-2.1.8~/doc/man1/pbs_resources_irix6.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_irix6.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_irix 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_irix - pbs resources on SGI Irix ++pbs_resources_irix \- pbs resources on SGI Irix + .SH DESCRIPTION + This page summarizes the resources supported by PBS for SGI workstations + running IRIX 6. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .LP + .SH RESOURCES +@@ -134,13 +134,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_irix6array.7B torque-2.1.8/doc/man1/pbs_resources_irix6array.7B +--- torque-2.1.8~/doc/man1/pbs_resources_irix6array.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_irix6array.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_irix 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_irix - pbs resources on SGI Irix ++pbs_resources_irix \- pbs resources on SGI Irix + .SH DESCRIPTION + This page summarizes the resources supported by PBS for SGI workstations + running IRIX 6. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .LP + .SH RESOURCES +@@ -134,13 +134,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_linux.7B torque-2.1.8/doc/man1/pbs_resources_linux.7B +--- torque-2.1.8~/doc/man1/pbs_resources_linux.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_linux.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_linux 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_linux - pbs resources on Linux ++pbs_resources_linux \- pbs resources on Linux + .SH DESCRIPTION + This page summarizes the resources supported by PBS for PC workstations + running Linux. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .LP + .SH RESOURCES +@@ -122,13 +122,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_netbsd.7B torque-2.1.8/doc/man1/pbs_resources_netbsd.7B +--- torque-2.1.8~/doc/man1/pbs_resources_netbsd.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_netbsd.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_Resources_netbsd 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_netbsd - pbs resources on NetBSD ++pbs_resources_netbsd \- pbs resources on NetBSD + .SH DESCRIPTION + This page summarizes the resources supported by PBS for + workstations running NetBSD on various hardware architectures. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .SH RESOURCES + .Iq +@@ -121,13 +121,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15 ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15 + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_solaris5.7B torque-2.1.8/doc/man1/pbs_resources_solaris5.7B +--- torque-2.1.8~/doc/man1/pbs_resources_solaris5.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_solaris5.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_solaris 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_solaris - pbs resources on SUN Solaris ++pbs_resources_solaris \- pbs resources on SUN Solaris + .SH DESCRIPTION + This page summarizes the resources supported by PBS for Sun workstations + running Solaris 2.x. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .LP + .SH RESOURCES +@@ -122,13 +122,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb script + .br +-qalter -lcput=30:00 123.jobid ++qalter \-lcput=30:00 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_solaris7.7B torque-2.1.8/doc/man1/pbs_resources_solaris7.7B +--- torque-2.1.8~/doc/man1/pbs_resources_solaris7.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_solaris7.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_solaris 7B "" Local PBS + .so ers.macros + .SH NAME +-pbs_resources_solaris - pbs resources on SUN Solaris ++pbs_resources_solaris \- pbs resources on SUN Solaris + .SH DESCRIPTION + This page summarizes the resources supported by PBS for Sun workstations + running Solaris 2.x. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .LP + .SH RESOURCES +@@ -122,13 +122,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb script + .br +-qalter -lcput=30:00 123.jobid ++qalter \-lcput=30:00 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,vmem=15mb + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_sp2.7B torque-2.1.8/doc/man1/pbs_resources_sp2.7B +--- torque-2.1.8~/doc/man1/pbs_resources_sp2.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_sp2.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,11 +79,11 @@ + .TH pbs_resources_sp2 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_sp2 - pbs resources on IBM SP-2 ++pbs_resources_sp2 \- pbs resources on IBM SP-2 + .SH DESCRIPTION + This page summarizes the resources supported by PBS for the IBM SP-2. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .SH RESOURCES + .Iq +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_sunos4.7B torque-2.1.8/doc/man1/pbs_resources_sunos4.7B +--- torque-2.1.8~/doc/man1/pbs_resources_sunos4.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_sunos4.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_Resources_sunos4 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_sunos4 - pbs resources on SunOS 4 ++pbs_resources_sunos4 \- pbs resources on SunOS 4 + .SH DESCRIPTION + This page summarizes the resources supported by PBS for Sun workstations + running SunOS 4.x. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .SH RESOURCES + .Iq +@@ -121,13 +121,13 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script ++qsub \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15mb script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .LP + or in a qsub script as a directive: + .LP +-#PBS -l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15 ++#PBS \-l cput=1:00:00,walltime=2:00:00,file=50gb,mem=15 + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_unicos8.7B torque-2.1.8/doc/man1/pbs_resources_unicos8.7B +--- torque-2.1.8~/doc/man1/pbs_resources_unicos8.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_unicos8.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_unicos 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_unicos - pbs resources under Unicos ++pbs_resources_unicos \- pbs resources under Unicos + .SH DESCRIPTION + This page summarizes the resources and special features supported by PBS + for Cray Research computers running Unicos versions 8 and 9. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .LP + .SH RESOURCES +@@ -165,17 +165,17 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,pcput=20:00,file=50gb,mem=15mb,mta=2 script ++qsub \-l cput=1:00:00,pcput=20:00,file=50gb,mem=15mb,mta=2 script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .br +-qsub -lsrfs_tmp=50mb,srfs_big=2gw script ++qsub \-lsrfs_tmp=50mb,srfs_big=2gw script + .LP + or in a qsub script as directives: + .LP +-#PBS -l cput=1:00:00,pcput=20:00,file=50gb,mem=15mb,mta=2 ++#PBS \-l cput=1:00:00,pcput=20:00,file=50gb,mem=15mb,mta=2 + .br +-#PBS -lsrfs_tmp=50mb,srfs_big=2gw ++#PBS \-lsrfs_tmp=50mb,srfs_big=2gw + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_resources_unicosmk2.7B torque-2.1.8/doc/man1/pbs_resources_unicosmk2.7B +--- torque-2.1.8~/doc/man1/pbs_resources_unicosmk2.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_resources_unicosmk2.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,12 +79,12 @@ + .TH pbs_resources_unicosmk2 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_resources_unicosmk2 - pbs resources under Unicos MK2 ++pbs_resources_unicosmk2 \- pbs resources under Unicos MK2 + .SH DESCRIPTION + This page summarizes the resources and special features supported by PBS + for Cray Research computers running Unicos MK version 2. + These resources are specified by including them in the +-.I -l ++.I \-l + option argument on the qsub or qalter command or in the PBS job script. + .LP + .SH RESOURCES +@@ -161,17 +161,17 @@ + Units: time. + .so pbs_resources_all.so + .LP +-qsub -l cput=1:00:00,pcput=20:00,file=50gb,mem=15mb,mta=2 script ++qsub \-l cput=1:00:00,pcput=20:00,file=50gb,mem=15mb,mta=2 script + .br +-qalter -lcput=30:00,pmem=8mb 123.jobid ++qalter \-lcput=30:00,pmem=8mb 123.jobid + .br +-qsub -lsrfs_tmp=50mb,srfs_big=2gw script ++qsub \-lsrfs_tmp=50mb,srfs_big=2gw script + .LP + or in a qsub script as directives: + .LP +-#PBS -l cput=1:00:00,pcput=20:00,file=50gb,mem=15mb,mta=2 ++#PBS \-l cput=1:00:00,pcput=20:00,file=50gb,mem=15mb,mta=2 + .br +-#PBS -lsrfs_tmp=50mb,srfs_big=2gw ++#PBS \-lsrfs_tmp=50mb,srfs_big=2gw + .LP + .if !\n(Pb .ig Ig + .\" for ers only +diff -urNad torque-2.1.8~/doc/man1/pbs_server_attributes.7B torque-2.1.8/doc/man1/pbs_server_attributes.7B +--- torque-2.1.8~/doc/man1/pbs_server_attributes.7B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbs_server_attributes.7B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .TH pbs_server_attributes 7B "" Local PBS + .so ../ers/ers.macros + .SH NAME +-pbs_server_attributes - pbs server attributes ++pbs_server_attributes \- pbs server attributes + .SH DESCRIPTION + .Iq + .if !\n(Pb .ig Ig +@@ -381,7 +381,7 @@ + job owner, are allowed to query the status of or select the job. + Format: boolean (see acl_host_enable); + Requires full manager privilege to set or alter. +-default value: false - users may not query or select jobs owned by other users. ++default value: false \- users may not query or select jobs owned by other users. + .if !\n(Pb .ig Ig + [internal type: boolean] + .Ig +@@ -451,7 +451,7 @@ + in the PBS Administrator Guide. + Format: boolean (see + acl_host_enable); +-default value: value of -a option when server is invoked, if -a is not ++default value: value of \-a option when server is invoked, if \-a is not + specified, the value is recovered from the prior server run. If it has never + been set, the value is "false". + .if !\n(Pb .ig Ig +diff -urNad torque-2.1.8~/doc/man1/pbsdsh.1B torque-2.1.8/doc/man1/pbsdsh.1B +--- torque-2.1.8~/doc/man1/pbsdsh.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/pbsdsh.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -91,29 +91,29 @@ + the Portable Batch System, PBS. Pbsdsh uses the Task Manager + API, see tm_spawn(3), to distribute the program on the allocated nodes. + .LP +-When run without the -c or the -n option, pbsdsh will spawn the program ++When run without the \-c or the \-n option, pbsdsh will spawn the program + on all nodes allocated to the PBS job. The spawns take place concurrently \- + all execute at (about) the same time. + .Sh OPTIONS + .IP "-c copies" + The program is spawned on the first + .Ar Copies +-nodes allocated. This option is mutual exclusive with -n. ++nodes allocated. This option is mutual exclusive with \-n. + .IP "-n node" + The program is spawned on one node which is the +-.Ar node -th +-node allocted. This option is mutual exclusive with -c. ++.Ar node \-th ++node allocted. This option is mutual exclusive with \-c. + .IP "-h hostname" + The program is spawned on the node specified. +-.IP -o ++.IP \-o + Capture stdout of the spawned program. Normally stdout goes to the job's output. +-.IP -s ++.IP \-s + If this option is given, the program is run in turn on each + node, one after the other. +-.IP -u ++.IP \-u + The program is run once on each node (unique). This ignores the number + of allocated processers on a given node. +-.IP -v ++.IP \-v + Verbose output about error conditions and task exit status is produced. + .Sh OPERANDS + The first operand, +diff -urNad torque-2.1.8~/doc/man1/qalter.1B torque-2.1.8/doc/man1/qalter.1B +--- torque-2.1.8~/doc/man1/qalter.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/qalter.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -465,7 +465,7 @@ + It must consist of printable, non white space characters with the first + character alphabetic. + .if !\n(Pb .ig Ig +-[See the discussion of the -N option under qsub(1).] ++[See the discussion of the \-N option under qsub(1).] + The + .At Job_Name + attribute is reset to the name value. +@@ -510,7 +510,7 @@ + .IP "\-p priority" 8 + Replaces the priority of the job. The + .Ar priority +-argument must be a integer between -1024 and +1023 inclusive. ++argument must be a integer between \-1024 and +1023 inclusive. + .if !\n(Pb .ig Ig + The + .At Priority +@@ -607,11 +607,11 @@ + .IP "-v variable_list" 8 + Overrides the job's environmental variable list. + .IP "-W additional_attributes" 8 +-The -W option allows for the modification of additional job attributes. +-The general syntax of the -W is in the form: ++The \-W option allows for the modification of additional job attributes. ++The general syntax of the \-W is in the form: + .br + .ft 5 +-\ \ \ \ -W attr_name=value[,attr_name=value...] ++\ \ \ \ \-W attr_name=value[,attr_name=value...] + .ft 1 + .br + Note if white space occurs anywhere within the option argument string or the +@@ -620,7 +620,7 @@ + string, then the string must be enclosed with either single or double quote + marks. + .IP +-PBS currently supports the following attributes within the -W option. ++PBS currently supports the following attributes within the \-W option. + .IP + .Ty "depend=dependency_list" + .br +diff -urNad torque-2.1.8~/doc/man1/qdel.1B torque-2.1.8/doc/man1/qdel.1B +--- torque-2.1.8~/doc/man1/qdel.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/qdel.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Iq + .Sh NAME +-qdel - delete pbs batch job ++qdel \- delete pbs batch job + .Sh SYNOPSIS + qdel + [\-W delay] +diff -urNad torque-2.1.8~/doc/man1/qhold.1B torque-2.1.8/doc/man1/qhold.1B +--- torque-2.1.8~/doc/man1/qhold.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/qhold.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Iq + .Sh NAME +-qhold - hold pbs batch jobs ++qhold \- hold pbs batch jobs + .Sh SYNOPSIS + qhold + [\-h hold_list] +diff -urNad torque-2.1.8~/doc/man1/qmgr.1B torque-2.1.8/doc/man1/qmgr.1B +--- torque-2.1.8~/doc/man1/qmgr.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/qmgr.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -148,20 +148,20 @@ + be written to standard output when qmgr is ready to read a directive. + .LP + If the +-.Ar -e ++.Ar \-e + option is specified, + .B qmgr + will echo the directives read from standard input to standard output. + .Sh STANDARD ERROR + If the +-.Ar -z ++.Ar \-z + option is not specified, the qmgr command will write a diagnostic message + to standard error for each error occurrence. + .Sh EXTENDED DESCRIPTION + If + .B qmgr + is invoked without the +-.Ar -c ++.Ar \-c + option and standard output is connected to a terminal, qmgr will write a + prompt to standard output and read a directive from + standard input. +@@ -235,7 +235,7 @@ + current value is replaced with the new value. + .IP += + increase the current value of the attribute by the amount in the new value. +-.IP -= ++.IP \-= + decrease the current value of the attribute by the amount in the new value. + .RE + .IP value +diff -urNad torque-2.1.8~/doc/man1/qmsg.1B torque-2.1.8/doc/man1/qmsg.1B +--- torque-2.1.8~/doc/man1/qmsg.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/qmsg.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -104,9 +104,9 @@ + Specifies that the message is written to the standard output of each job. + .LP + If neither the +-.Ar -E ++.Ar \-E + nor the +-.Ar -O ++.Ar \-O + option is specified, the message will be written to the standard error + of the job. + .Sh OPERANDS +diff -urNad torque-2.1.8~/doc/man1/qrerun.1B torque-2.1.8/doc/man1/qrerun.1B +--- torque-2.1.8~/doc/man1/qrerun.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/qrerun.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -105,7 +105,7 @@ + .At Rerunable + attribute and the + .Ig +-.Ar -r ++.Ar \-r + option on the + .B qsub + and +diff -urNad torque-2.1.8~/doc/man1/qrls.1B torque-2.1.8/doc/man1/qrls.1B +--- torque-2.1.8~/doc/man1/qrls.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/qrls.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -109,7 +109,7 @@ + correct privilege is an error and no holds will be released for that job. + .LP + If no +-.Ar -h ++.Ar \-h + option is specified, the + .Av USER + hold will be released. +diff -urNad torque-2.1.8~/doc/man1/qselect.1B torque-2.1.8/doc/man1/qselect.1B +--- torque-2.1.8~/doc/man1/qselect.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/qselect.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -105,7 +105,7 @@ + which might be listed. With no options, the qselect + command will list all jobs at the server which the user is authorized + to list (query status of). +-The -u option may be used to limit the selection to jobs owned by this user ++The \-u option may be used to limit the selection to jobs owned by this user + or other specified users. + .if !\n(Pb .ig Ig + Operators and system administrators have the privilege to select all jobs. +@@ -420,7 +420,7 @@ + .Ty "\ \ \ \ queue@server" + .LP + If the +-.Ar -q ++.Ar \-q + option is not specified, jobs will be selected from the default server. + .if !\n(Pb .ig Ig + See the ERS section \*(Si for a definition of the default server. +diff -urNad torque-2.1.8~/doc/man1/qsig.1B torque-2.1.8/doc/man1/qsig.1B +--- torque-2.1.8~/doc/man1/qsig.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/qsig.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -96,13 +96,13 @@ + .B `SIGTERM' + is sent. + The request to signal a batch job will be rejected if: +-.IP - ++.IP \- + The user is not authorized to signal the job. +-.IP - ++.IP \- + The job is not in the + .B running + state. +-.IP - ++.IP \- + The requested signal is not supported by the system upon which the + job is executing. + .LP +diff -urNad torque-2.1.8~/doc/man1/qstat.1B torque-2.1.8/doc/man1/qstat.1B +--- torque-2.1.8~/doc/man1/qstat.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/qstat.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -86,11 +86,11 @@ + qstat [-a|-i|-r|-e] [-n [-1]] [-s] [-G|-M] [-R] [-u user_list] [\^job_identifier... |\ + destination...\^] + .sp +-qstat -Q [-f [-1]][-W site_specific] [\^destination...\^] ++qstat \-Q [-f [-1]][-W site_specific] [\^destination...\^] + .sp +-qstat -q [-G|-M] [\^destination...\^] ++qstat \-q [-G|-M] [\^destination...\^] + .sp +-qstat -B [-f [-1]][-W site_specific] [\^server_name...\^] ++qstat \-B [-f [-1]][-W site_specific] [\^server_name...\^] + .Sh DESCRIPTION + The + .B qstat +@@ -124,7 +124,7 @@ + will output information about each + .Ar destination . + .if !\n(Pb .ig Ig +-The syntax using the [-a|-i|-r|-e] line or the -q line are extensions to POSIX. ++The syntax using the [-a|-i|-r|-e] line or the \-q line are extensions to POSIX. + .Ig + .Sh OPTIONS + .IP "-f" 10 +@@ -152,8 +152,8 @@ + .IP "-n" 10 + In addition to the basic information, nodes allocated to a job are listed. + .IP "-1" 10 +-In combination with -n, the -1 option puts all of the nodes on the same line as +-the job ID. In combination with -f, attributes are not folded to fit in a ++In combination with \-n, the \-1 option puts all of the nodes on the same line as ++the job ID. In combination with \-f, attributes are not folded to fit in a + terminal window. This is intended to ease the parsing of the qstat output. + .IP "-s" 10 + In addition to the basic information, any comment provided by the batch +@@ -192,9 +192,9 @@ + .LP + .Sh OPERANDS + If neither the +-.Ar -Q ++.Ar \-Q + nor the +-.Ar -B ++.Ar \-B + option is given, the operands on the qstat + command must be either job identifiers or destinations identifiers. + .LP +@@ -239,7 +239,7 @@ + named server. + .LP + If the +-.Ar -Q ++.Ar \-Q + option is given, the operands are destination identifiers as specified + above. If + .Ty queue +@@ -255,44 +255,44 @@ + server will be given. + .LP + If the +-.Ar -B ++.Ar \-B + option is given, the operand is the name of a server. + .Sh STANDARD OUTPUT + Displaying Job Status + .LP + If job status is being displayed in the default format and the +-.Ar -f ++.Ar \-f + option is not specified, the following items are displayed on a single + line, in the specified order, separated by white space: + .RS +-.IP - 3 ++.IP \- 3 + the job identifier assigned by PBS. +-.IP - ++.IP \- + the job name given by the submitter. +-.IP - ++.IP \- + the job owner +-.IP - ++.IP \- + the CPU time used +-.IP - ++.IP \- + the job state: + .RS 0.5i +-C - Job is completed after having run/ ++C \- Job is completed after having run/ + .br +-E - Job is exiting after having run. ++E \- Job is exiting after having run. + .br +-H - Job is held. ++H \- Job is held. + .br +-Q - job is queued, eligible to run or routed. ++Q \- job is queued, eligible to run or routed. + .br +-R - job is running. ++R \- job is running. + .br +-T - job is being moved to new location. ++T \- job is being moved to new location. + .br +-W - job is waiting for its execution time ++W \- job is waiting for its execution time + .br + (-a option) to be reached. + .br +-S - (Unicos only) job is suspend. ++S \- (Unicos only) job is suspend. + .br + .if !\n(Pb .ig Ig + .SM +@@ -301,12 +301,12 @@ + .NL + .Ig + .RE +-.IP - ++.IP \- + the queue in which the job resides + .RE + .LP + If job status is being displayed and the +-.Ar -f ++.Ar \-f + option is specified, the output will depend on whether + .B qstat + was compiled to use a +@@ -332,59 +332,59 @@ + There is blank line following the last attribute. + .Ig + .LP +-If any of the options -a, -i, -r, -u, -n, -s, -G or -M are provided, ++If any of the options \-a, \-i, \-r, \-u, \-n, \-s, \-G or \-M are provided, + the alternative display format for jobs is used. + The following items are displayed on a single + line, in the specified order, separated by white space: + .RS +-.IP - 3 ++.IP \- 3 + the job identifier assigned by PBS. +-.IP - ++.IP \- + the job owner. +-.IP - ++.IP \- + The queue in which the job currently resides. +-.IP - ++.IP \- + The job name given by the submitter. +-.IP - ++.IP \- + The session id (if the job is running). +-.IP - ++.IP \- + The number of nodes requested by the job. +-.IP - ++.IP \- + The number of cpus or tasks requested by the job. +-.IP - ++.IP \- + The amount of memory requested by the job. +-.IP - ++.IP \- + Either the cpu time, if specified, or wall time requested by the job, (hh:mm). +-.IP - ++.IP \- + The job's current state. +-.IP - ++.IP \- + The amount of cpu time or wall time used by the job (hh:mm). + .RE +-If the -R option is provided, the line contains: ++If the \-R option is provided, the line contains: + .RS +-.IP - 3 ++.IP \- 3 + the job identifier assigned by PBS. +-.IP - ++.IP \- + the job owner. +-.IP - ++.IP \- + The queue in which the job currently resides. +-.IP - ++.IP \- + The number of nodes requested by the job. +-.IP - ++.IP \- + The number of cpus or tasks requested by the job. +-.IP - ++.IP \- + The amount of memory requested by the job. +-.IP - ++.IP \- + Either the cpu time or wall time requested by the job. +-.IP - ++.IP \- + The job's current state. +-.IP - ++.IP \- + The amount of cpu time or wall time used by the job. +-.IP - ++.IP \- + The amount of SRFS space requested on the big file system. +-.IP - ++.IP \- + The amount of SRFS space requested on the fast file system. +-.IP - ++.IP \- + The amount of space requested on the parallel I/O file system. + .RE + The last three fields may not contain useful information at all sites +@@ -393,29 +393,29 @@ + Displaying Queue Status + .LP + If queue status is being displayed and the +-.Ar -f ++.Ar \-f + option was not specified, the following items are displayed on a single + line, in the specified order, separated by white space: + .RS 5 +-.IP - ++.IP \- + the queue name +-.IP - ++.IP \- + the maximum number of jobs that may be run in the queue concurrently +-.IP - ++.IP \- + the total number of jobs in the queue +-.IP - ++.IP \- + the enable or disabled status of the queue +-.IP - ++.IP \- + the started or stopped status of the queue +-.IP - ++.IP \- + for each job state, the name of the state and the number of jobs in the queue + in that state. +-.IP - ++.IP \- + the type of queue, execution or routing. + .RE + .LP + If queue status is being displayed and the +-.Ar -f ++.Ar \-f + option is specified, the output will depend on whether + .B qstat + was compiled to use a +@@ -437,27 +437,27 @@ + The queue attributes are listed in the same format as job attributes. + .Ig + .LP +-If the -q option is specified, queue information is displayed in the ++If the \-q option is specified, queue information is displayed in the + alternative format: The following information is displayed on a single + line: + .RS +-.IP - 3 ++.IP \- 3 + the queue name +-.IP - ++.IP \- + the maximum amount of memory a job in the queue may request +-.IP - ++.IP \- + the maximum amount of cpu time a job in the queue may request +-.IP - ++.IP \- + the maximum amount of wall time a job in the queue may request +-.IP - ++.IP \- + the maximum amount of nodes a job in the queue may request +-.IP - ++.IP \- + the number of jobs in the queue in the running state +-.IP - ++.IP \- + the number of jobs in the queue in the queued state +-.IP - ++.IP \- + the maximum number (limit) of jobs that may be run in the queue concurrently +-.IP - ++.IP \- + the state of the queue given by a pair of letters: + .br + - either the letter E if the queue is Enabled or D if Disabled, and +@@ -468,25 +468,25 @@ + Displaying Server Status + .LP + If batch server status is being displayed and the +-.Ar -f ++.Ar \-f + option is not specified, the following items are displayed on a single + line, in the specified order, separated by white space: + .RS 5 +-.IP - ++.IP \- + the server name +-.IP - ++.IP \- + the maximum number of jobs that the server may run concurrently +-.IP - ++.IP \- + the total number of jobs currently managed by the server +-.IP - ++.IP \- + the status of the server +-.IP - ++.IP \- + for each job state, the name of the state and the number of jobs in the + server in that state + .RE + .LP + If server status is being displayed and the +-.Ar -f ++.Ar \-f + option is specified, the output will depend on whether + .B qstat + was compiled to use a +@@ -517,7 +517,7 @@ + is compiled with an option to include a + .B Tcl + interpreter, using the +-.Ar -f ++.Ar \-f + flag to get a full display causes a check to be made for a script file + to use to output the requested information. The first location checked + is $HOME/.qstatrc. If this does not exist, the next location +@@ -543,13 +543,13 @@ + together on the command line, they are separated in the list. + For example, if the user typed + .LP +-.Ty "qstat -QfWbigdisplay" ++.Ty "qstat \-QfWbigdisplay" + .LP + the + .B flags + list would contain + .LP +-.Ty "qstat -Q -f -W bigdisplay" ++.Ty "qstat \-Q \-f \-W bigdisplay" + .LP + The + .B operands +diff -urNad torque-2.1.8~/doc/man1/qsub.1B torque-2.1.8/doc/man1/qsub.1B +--- torque-2.1.8~/doc/man1/qsub.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/qsub.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -147,7 +147,7 @@ + .Ty PBS_BATCH + to indicate the job is a batch job, or to + .Ty PBS_INTERACTIVE +-to indicate the job is a PBS interactive job, see -I option. ++to indicate the job is a PBS interactive job, see \-I option. + .IP \f3PBS_JOBID\fP + the job identifier assigned to the job by the batch system. + .IP \f3PBS_JOBNAME\fP +@@ -272,7 +272,7 @@ + .Ar """c=minutes""" . + .IP + If +-.Ar -c ++.Ar \-c + is not specified, the + .At Checkpoint + attribute is set to the value +@@ -286,7 +286,7 @@ + Extended Description section. + .IP + If the +-.Ar -C ++.Ar \-C + option is presented with a + .Ar directive_prefix + argument that is the null string, qsub +@@ -297,7 +297,7 @@ + .Ig + .IP "\-d path" 8 + Defines the working directory path to be used for the job. If the +-.Ar -d ++.Ar \-d + option is not specified, the default working directory is the home directory. + This option sets the environment variable PBS_O_INITDIR. + .Ig +@@ -342,14 +342,14 @@ + .RE + .IP + If the +-.Ar -e ++.Ar \-e + option is not specified, the default file name for the standard error stream + will be used. The default name has the following form: + .br + \ \ \ \ \f5job_name.\f6e\f5sequence_number\f1 + .br + where \f5job_name\fP is the name of the job, see +-.Ar -N ++.Ar \-N + option, and \f5sequence_number\f1 is the job number assigned when the + job is submitted. + .if !\n(Pb .ig Ig +@@ -362,7 +362,7 @@ + The + .At Hold_Types + attribute will be set to USER, "u". +-If -h is not specified, then ++If \-h is not specified, then + .At Hold_Types + is set to NONE, "n". + .Ig +@@ -621,14 +621,14 @@ + .RE + .IP + If the +-.Ar -o ++.Ar \-o + option is not specified, the default file name for the standard output stream + will be used. The default name has the following form: + .br + \ \ \ \ \f5job_name.\f6o\f5sequence_number\f1 + .br + where \f5job_name\fP is the name of the job, see +-.Ar -N ++.Ar \-N + option, and \f5sequence_number\f1 is the job number assigned when the + job is submitted. + .if !\n(Pb .ig Ig +@@ -638,7 +638,7 @@ + .IP "\-p priority" 8 + Defines the priority of the job. The + .Ar priority +-argument must be a integer between -1024 and +1023 inclusive. ++argument must be a integer between \-1024 and +1023 inclusive. + The default is no priority which is equivalent to a priority of zero. + .if !\n(Pb .ig Ig + The +@@ -800,15 +800,15 @@ + command's environment and their values. + .Ig + .IP "-W additional_attributes" 8 +-The -W option allows for the specification of additional job attributes. ++The \-W option allows for the specification of additional job attributes. + .if !\n(Pb .ig Ig + .SM + POSIX.2 reserves all undefined option letters for future versions of the + standard. The single letter 'W' is allowed for extensions. PBS makes use +-of the -W to specify attributes which are extensions to POSIX 1003.2d. ++of the \-W to specify attributes which are extensions to POSIX 1003.2d. + .NL + .Ig +-The general syntax of the -W is in the form: ++The general syntax of the \-W is in the form: + .br + .ft 5 + \ \ \ \ \-W\ attr_name=attr_value[,attr_name=attr_value...] +@@ -820,7 +820,7 @@ + string, then the string must be enclosed with either single or double quote + marks. + .IP +-PBS currently supports the following attributes within the -W option. ++PBS currently supports the following attributes within the \-W option. + .IP + .Ty "depend=dependency_list" + .br +@@ -912,9 +912,9 @@ + .LP + Dependency examples: + .br +-.Ty "qsub -W depend=afterok:123.big.iron.com /tmp/script" ++.Ty "qsub \-W depend=afterok:123.big.iron.com /tmp/script" + .br +-.Ty "qsub -W depend=before:234.hunk1.com:235.hunk1.com /tmp/script" ++.Ty "qsub \-W depend=before:234.hunk1.com:235.hunk1.com /tmp/script" + .RE + .IP + .Ty group_list=g_list +@@ -1053,7 +1053,7 @@ + each error occurrence. + .Sh ENVIRONMENT VARIABLES + The values of some or all of the variables in the qsub +-command's environment are exported with the job, see the -v and -V options. ++command's environment are exported with the job, see the \-v and \-V options. + .LP + The environment variable + .B PBS_DEFAULT +@@ -1068,7 +1068,7 @@ + .LP + The environment variable + .B PBS_CLIENTRETRY +-defines the maximum number of seconds qsub will block. See the -b option ++defines the maximum number of seconds qsub will block. See the \-b option + above. Despite the name, currently qsub is the only client that supports + this option. + .Sh EXTENDED DESCRIPTION +@@ -1082,9 +1082,9 @@ + .RS + .Cs + : +-#PBS -N Job_name +-#PBS -l walltime=10:30,mem=320kb +-#PBS -m be ++#PBS \-N Job_name ++#PBS \-l walltime=10:30,mem=320kb ++#PBS \-m be + # + step1 arg1 arg2 + step2 arg3 arg4 +@@ -1141,7 +1141,7 @@ + .LP + When the user submits a job from a system other than the one on which the + PBS Server is running, the name under which the job is to be executed is +-selected according to the rules listed under the -u option. ++selected according to the rules listed under the \-u option. + The user submitting the job must be authorized to run the job under the + execution user name. + This authorization is provided if +diff -urNad torque-2.1.8~/doc/man1/xpbs.1B torque-2.1.8/doc/man1/xpbs.1B +--- torque-2.1.8~/doc/man1/xpbs.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/xpbs.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -102,7 +102,7 @@ + Preference settings defined by the system administrator in the global xpbsrc + file + .IP "3." +-User's ~/.xpbsrc file - this file defines various X resources like fonts, ++User's ~/.xpbsrc file \- this file defines various X resources like fonts, + colors, list + of PBS hosts to query, criteria for listing queues and jobs, and various view + states. See PREFERENCES section below for a list of resources that can be set. +@@ -120,7 +120,7 @@ + stopping and starting queues, or running/rerunning jobs, then run: + .RS + .sp +-.Ty "\ \ \ xpbs -admin" ++.Ty "\ \ \ xpbs \-admin" + .sp + .RE + NOTE: Be sure to appropriately set ~/.rhosts file if you're planning to submit +@@ -310,7 +310,7 @@ + described in the following: + .sp + .IP "1." 3 +-\f3listbox\fP - can be multi-selectable (a number of entries can be ++\f3listbox\fP \- can be multi-selectable (a number of entries can be + selected/highlighted using a mouse click) or single-selectable (one entry + can be highlighted at a time). For a multi-selectable listbox, + the following operations are allowed: +@@ -338,7 +338,7 @@ + .sp + .RE + .IP "2." 3 +-\f3scrollbar\fP - usually appears either vertically or ++\f3scrollbar\fP \- usually appears either vertically or + horizontally and contains 5 distinct areas that are mouse + clicked to achieve different effects: + .RS +@@ -375,7 +375,7 @@ + .RE + .sp + .IP "3." 3 +-\f3entry\fP - brought into focus with a click of the left ++\f3entry\fP \- brought into focus with a click of the left + mouse button. To manipulate this widget, simply type in + the text value. Use of arrow keys, mouse selection of + text for deletion or overwrite, copying and pasting with +@@ -384,7 +384,7 @@ + horizontally scanning a long text entry string. + .sp + .IP "4." 3 +-\f3matrix of entry boxes\fP - usually shown as several ++\f3matrix of entry boxes\fP \- usually shown as several + rows of entry widgets where a number of entries (called + fields) can be found per row. The matrix is accompanied by + up/down arrow buttons for paging through the rows of data, +@@ -394,18 +394,18 @@ + backwards) keys. + .sp + .IP "5." 3 +-\f3spinbox\fP - a combination of an entry widget and a ++\f3spinbox\fP \- a combination of an entry widget and a + horizontal scrollbar. The entry widget will only accept + values that fall within a defined list of valid values, and + incrementing through the valid values is done by clicking on + the up/down arrows. + .IP "6." 3 +-\f3button\fP - a rectangular region appearing either raised or ++\f3button\fP \- a rectangular region appearing either raised or + pressed that invokes an action when clicked with the left + mouse button. When the button appears pressed, then hitting + the key will automatically select the button. + .IP "7." 3 +-\f3text\fP - an editor like widget. This widget is brought ++\f3text\fP \- an editor like widget. This widget is brought + into focus with a click of the left mouse button. To manipulate + this widget, simply type in the text. Use of arrow keys, + backspace/delete key, mouse selection of text for deletion or +@@ -563,7 +563,7 @@ + was run. If the output files are returned to some remote host, then + \f3xpbs\fP will execute an + .br +-.Ty "\ \ \ RSH test -f " ++.Ty "\ \ \ RSH test \-f " + .br + to test the existence of the files. RSH is whatever you set the remote shell + command to in the corresponding entry box. +@@ -575,12 +575,12 @@ + .Ar "start/reset tracking" + button located at the bottom of the dialog box to: + .RS +-.IP - 2 ++.IP \- 2 + cancel any previous tracking +-.IP - 2 ++.IP \- 2 + build a new list of jobs to be monitored for returned + output files based on currently queued jobs. +-.IP - 2 ++.IP \- 2 + start periodic tracking. + .RE + .IP "7." +@@ -659,60 +659,60 @@ + list of owners checked when limiting the + jobs appearing on the Jobs listbox in the main \f3xpbs\fP window. + Specify value as "Owners: ". +-See -u option in \f3qselect(1B)\fP for format of . ++See \-u option in \f3qselect(1B)\fP for format of . + .IP *selectStates + list of job states to look for (do not space separate) when + limiting the jobs appearing on the Jobs listbox in the main + \f3xpbs\fP window. + Specify value as "Job_States: ". +-See -s option in \f3qselect(1B)\fP for format of . ++See \-s option in \f3qselect(1B)\fP for format of . + .IP *selectRes + list of resource amounts (space separated) to consult when + limiting the jobs appearing on the Jobs listbox in the main + \f3xpbs\fP window. + Specify value as "Resources: ". +-See -l option in \f3qselect(1B)\fP for format of . ++See \-l option in \f3qselect(1B)\fP for format of . + .IP *selectExecTime + the Execution Time attribute to consult when limiting the + list of jobs appearing on the Jobs listbox in the main + \f3xpbs\fP window. + Specify value as "Queue_Time: ". +-See -a option in \f3qselect(1B)\fP for format of . ++See \-a option in \f3qselect(1B)\fP for format of . + .IP *selectAcctName + the name of the account that will be checked when limiting the + jobs appearing on the Jobs listbox in the main \f3xpbs\fP + window. + Specify value as "Account_Name: ". +-See -A option in \f3qselect(1B)\fP for format of . ++See \-A option in \f3qselect(1B)\fP for format of . + .IP *selectCheckpoint + the checkpoint attribute relationship (including the logical + operator) to consult when limiting the list of jobs + appearing on the Jobs listbox in the main \f3xpbs\fP window. + Specify value as "Checkpoint: ". +-See -c option in \f3qselect(1B)\fP for format of . ++See \-c option in \f3qselect(1B)\fP for format of . + .IP *selectHold + the hold types string to look for in a job when limiting the + jobs appearing on the Jobs listbox in the main \f3xpbs\fP + window. + Specify value as "Hold_Types: ". +-See -h option in \f3qselect(1B)\fP for format of . ++See \-h option in \f3qselect(1B)\fP for format of . + .IP *selectPriority + the priority relationship (including the logical operator) to + consult when limiting the list of jobs appearing on the Jobs + listbox in the main \f3xpbs\fP window. + Specify value as "Priority: ". +-See -p option in \f3qselect(1B)\fP for format of . ++See \-p option in \f3qselect(1B)\fP for format of . + .IP *selectRerun + the rerunnable attribute to consult when limiting the list of + jobs appearing on the Jobs listbox in the main \f3xpbs\fP + window. + Specify value as "Rerunnable: ". +-See -r option in \f3qselect(1B)\fP for format of . ++See \-r option in \f3qselect(1B)\fP for format of . + .IP *selectJobName + name of the job that will be checked when limiting the jobs + appearing on the Jobs listbox in the main \f3xpbs\fP window. + Specify value as "Job_Name: ". +-See -N option in \f3qselect(1B)\fP for format of . ++See \-N option in \f3qselect(1B)\fP for format of . + .IP *iconizeHostsView + a boolean value (true or false) indicating whether or not to + iconize the HOSTS region. +@@ -742,11 +742,11 @@ + .IP "\f3Command Button\fP" 22 + \f3PBS Command\fP + .IP "detail (Hosts)" 22 +-qstat -B -f ++qstat \-B \-f + .IP "terminate" 22 + qterm + .IP "detail (Queues)" 22 +-qstat -Q -f ++qstat \-Q \-f + .IP "stop" 22 + qstop + .IP "start" 22 +@@ -756,7 +756,7 @@ + .IP "disable" 22 + qdisable + .IP "detail (Jobs)" 22 +-qstat -f ++qstat \-f + .IP "modify" 22 + qalter + .IP "delete" 22 +diff -urNad torque-2.1.8~/doc/man1/xpbsmon.1B torque-2.1.8/doc/man1/xpbsmon.1B +--- torque-2.1.8~/doc/man1/xpbsmon.1B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man1/xpbsmon.1B 2008-01-14 14:56:13.000000000 +0100 +@@ -106,7 +106,7 @@ + Preference settings defined by the system administrator in the global xpbsmonrc + file + .IP "3." +-User's ~/.xpbsmonrc file - this file defines various X resources like fonts, ++User's ~/.xpbsmonrc file \- this file defines various X resources like fonts, + colors, list of colors to use to represent the various status of the nodes, + list of PBS sites to query, list of server hosts on each site, list of + nodes/execution hosts on each server host, list of system resource queries to +@@ -235,10 +235,10 @@ + described in the following: + .sp + .IP "1." 3 +-\f3listbox\fP - the ones found in this GUI are only single-selectable ++\f3listbox\fP \- the ones found in this GUI are only single-selectable + (one entry can be highlighted/selected at a time via a mouse click). + .IP "2." 3 +-\f3scrollbar\fP - usually appears either vertically or ++\f3scrollbar\fP \- usually appears either vertically or + horizontally and contains 5 distinct areas that are mouse + clicked to achieve different effects: + .RS +@@ -275,7 +275,7 @@ + .RE + .sp + .IP "3." 3 +-\f3entry\fP - brought into focus with a click of the left ++\f3entry\fP \- brought into focus with a click of the left + mouse button. To manipulate this widget, simply type in + the text value. Use of arrow keys, mouse selection of + text for deletion or overwrite, copying and pasting with +@@ -284,7 +284,7 @@ + horizontally scanning a long text entry string. + .sp + .IP "4." 3 +-\f3box\fP - made up of 1 or more listboxes displayed adjacent ++\f3box\fP \- made up of 1 or more listboxes displayed adjacent + to each other giving the effect of a "matrix". Each row + from the listboxes makes up an element of the box. In order + to add items to the box, you need to manipulate the accompanying +@@ -293,13 +293,13 @@ + element, and then clicking \f3delete\fP. + .sp + .IP "5." 3 +-\f3spinbox\fP - a combination of an entry widget and a ++\f3spinbox\fP \- a combination of an entry widget and a + horizontal scrollbar. The entry widget will only accept + values that fall within a defined list of valid values, and + incrementing through the valid values is done by clicking on + the up/down arrows. + .IP "6." 3 +-\f3button\fP - a rectangular region appearing either raised or ++\f3button\fP \- a rectangular region appearing either raised or + pressed that invokes an action when clicked with the left + mouse button. When the button appears pressed, then hitting + the key will automatically select the button. +diff -urNad torque-2.1.8~/doc/man3/pbs_alterjob.3B torque-2.1.8/doc/man3/pbs_alterjob.3B +--- torque-2.1.8~/doc/man3/pbs_alterjob.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_alterjob.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_alterjob - alter pbs batch job ++pbs_alterjob \- alter pbs batch job + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_connect.3B torque-2.1.8/doc/man3/pbs_connect.3B +--- torque-2.1.8~/doc/man3/pbs_connect.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_connect.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_connect - connect to a pbs batch server ++pbs_connect \- connect to a pbs batch server + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_default.3B torque-2.1.8/doc/man3/pbs_default.3B +--- torque-2.1.8~/doc/man3/pbs_default.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_default.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_default - return the pbs default server name ++pbs_default \- return the pbs default server name + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_deljob.3B torque-2.1.8/doc/man3/pbs_deljob.3B +--- torque-2.1.8~/doc/man3/pbs_deljob.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_deljob.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_deljob - delete a pbs batch job ++pbs_deljob \- delete a pbs batch job + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_disconnect.3B torque-2.1.8/doc/man3/pbs_disconnect.3B +--- torque-2.1.8~/doc/man3/pbs_disconnect.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_disconnect.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_disconnect - disconnect from a pbs batch server ++pbs_disconnect \- disconnect from a pbs batch server + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_geterrmsg.3B torque-2.1.8/doc/man3/pbs_geterrmsg.3B +--- torque-2.1.8~/doc/man3/pbs_geterrmsg.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_geterrmsg.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_geterrmsg - get error message for last pbs batch operation ++pbs_geterrmsg \- get error message for last pbs batch operation + .Sh SYNOPSIS + #include + .br +@@ -96,7 +96,7 @@ + .LP + .if !\n(Pb .ig Ig + Because different server implementations may have different error conditions, +-the batch request - reply protocol allows for the server to include the ++the batch request \- reply protocol allows for the server to include the + text of an error message in the reply to a batch request. + .LP + .Ig +diff -urNad torque-2.1.8~/doc/man3/pbs_holdjob.3B torque-2.1.8/doc/man3/pbs_holdjob.3B +--- torque-2.1.8~/doc/man3/pbs_holdjob.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_holdjob.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_holdjob - place a hold on a pbs batch job ++pbs_holdjob \- place a hold on a pbs batch job + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_locate.3B torque-2.1.8/doc/man3/pbs_locate.3B +--- torque-2.1.8~/doc/man3/pbs_locate.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_locate.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_locjob - locate current location of a pbs batch job ++pbs_locjob \- locate current location of a pbs batch job + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_manager.3B torque-2.1.8/doc/man3/pbs_manager.3B +--- torque-2.1.8~/doc/man3/pbs_manager.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_manager.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_manager - administrator a pbs batch object ++pbs_manager \- administrator a pbs batch object + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_movejob.3B torque-2.1.8/doc/man3/pbs_movejob.3B +--- torque-2.1.8~/doc/man3/pbs_movejob.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_movejob.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_movejob - move a pbs batch job to a new destination ++pbs_movejob \- move a pbs batch job to a new destination + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_msgjob.3B torque-2.1.8/doc/man3/pbs_msgjob.3B +--- torque-2.1.8~/doc/man3/pbs_msgjob.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_msgjob.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_msgjob - record a message for a running pbs batch job ++pbs_msgjob \- record a message for a running pbs batch job + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_orderjob.3B torque-2.1.8/doc/man3/pbs_orderjob.3B +--- torque-2.1.8~/doc/man3/pbs_orderjob.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_orderjob.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_orderjob - reorder pbs batch jobs in a queue ++pbs_orderjob \- reorder pbs batch jobs in a queue + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_rerunjob.3B torque-2.1.8/doc/man3/pbs_rerunjob.3B +--- torque-2.1.8~/doc/man3/pbs_rerunjob.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_rerunjob.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_rerunjob - rerun a pbs batch job ++pbs_rerunjob \- rerun a pbs batch job + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_rescquery.3B torque-2.1.8/doc/man3/pbs_rescquery.3B +--- torque-2.1.8~/doc/man3/pbs_rescquery.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_rescquery.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_rescquery, avail, totpool, usepool - query resource availability ++pbs_rescquery, avail, totpool, usepool \- query resource availability + .Sh SYNOPSIS + #include + .br +@@ -131,7 +131,7 @@ + .br + .Ty \ \ \ \ nodes=\f2specification\f1 + .br +-where specification is what a user specifies in the -l option arguement list ++where specification is what a user specifies in the \-l option arguement list + for nodes, see qsub(1B) and the various pbs_resource_* man pages. + .IP + Where the node resourcelist is a simple type, such as "nodes", "nodes=", +@@ -229,7 +229,7 @@ + Otherwise, a non zero error is returned. The error number is also set + in pbs_errno. + .LP +-The functions usepool() and totpool() return -1 on error. ++The functions usepool() and totpool() return \-1 on error. + \" turn off any extra indent left by the Sh macro + .RE + +diff -urNad torque-2.1.8~/doc/man3/pbs_rescreserve.3B torque-2.1.8/doc/man3/pbs_rescreserve.3B +--- torque-2.1.8~/doc/man3/pbs_rescreserve.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_rescreserve.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_rescreserve, pbs_rescrelease - reserve/free batch resources ++pbs_rescreserve, pbs_rescrelease \- reserve/free batch resources + .Sh SYNOPSIS + #include + .br +@@ -129,7 +129,7 @@ + At the present time the only resources which may be specified are "nodes". + It should be specified as + .Ty nodes=specification +-where specification is what a user specifies in the -l option arguement list ++where specification is what a user specifies in the \-l option arguement list + for nodes, see + .I qsub (1B). + .if \n(Pb .ig Ig +diff -urNad torque-2.1.8~/doc/man3/pbs_rlsjob.3B torque-2.1.8/doc/man3/pbs_rlsjob.3B +--- torque-2.1.8~/doc/man3/pbs_rlsjob.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_rlsjob.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_rlsjob - release a hold on a pbs batch job ++pbs_rlsjob \- release a hold on a pbs batch job + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_runjob.3B torque-2.1.8/doc/man3/pbs_runjob.3B +--- torque-2.1.8~/doc/man3/pbs_runjob.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_runjob.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_runjob - run a pbs batch job ++pbs_runjob \- run a pbs batch job + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_selectjob.3B torque-2.1.8/doc/man3/pbs_selectjob.3B +--- torque-2.1.8~/doc/man3/pbs_selectjob.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_selectjob.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_selectjob - select pbs batch jobs ++pbs_selectjob \- select pbs batch jobs + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_selstat.3B torque-2.1.8/doc/man3/pbs_selstat.3B +--- torque-2.1.8~/doc/man3/pbs_selstat.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_selstat.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_selstat - obtain status of selected pbs batch jobs ++pbs_selstat \- obtain status of selected pbs batch jobs + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_sigjob.3B torque-2.1.8/doc/man3/pbs_sigjob.3B +--- torque-2.1.8~/doc/man3/pbs_sigjob.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_sigjob.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_sigjob - send a signal to a pbs batch job ++pbs_sigjob \- send a signal to a pbs batch job + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_stagein.3B torque-2.1.8/doc/man3/pbs_stagein.3B +--- torque-2.1.8~/doc/man3/pbs_stagein.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_stagein.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_stagein - request that files for a pbs batch job be staged in. ++pbs_stagein \- request that files for a pbs batch job be staged in. + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_statjob.3B torque-2.1.8/doc/man3/pbs_statjob.3B +--- torque-2.1.8~/doc/man3/pbs_statjob.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_statjob.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_statjob - obtain status of pbs batch jobs ++pbs_statjob \- obtain status of pbs batch jobs + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_statnode.3B torque-2.1.8/doc/man3/pbs_statnode.3B +--- torque-2.1.8~/doc/man3/pbs_statnode.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_statnode.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_statnode - obtain status of pbs nodes ++pbs_statnode \- obtain status of pbs nodes + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_statque.3B torque-2.1.8/doc/man3/pbs_statque.3B +--- torque-2.1.8~/doc/man3/pbs_statque.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_statque.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_statque - obtain status of pbs batch queues ++pbs_statque \- obtain status of pbs batch queues + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_statserver.3B torque-2.1.8/doc/man3/pbs_statserver.3B +--- torque-2.1.8~/doc/man3/pbs_statserver.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_statserver.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_statserver - obtain status of a pbs batch server ++pbs_statserver \- obtain status of a pbs batch server + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_submit.3B torque-2.1.8/doc/man3/pbs_submit.3B +--- torque-2.1.8~/doc/man3/pbs_submit.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_submit.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_submit - submit a pbs batch job ++pbs_submit \- submit a pbs batch job + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/pbs_terminate.3B torque-2.1.8/doc/man3/pbs_terminate.3B +--- torque-2.1.8~/doc/man3/pbs_terminate.3B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man3/pbs_terminate.3B 2008-01-14 14:56:13.000000000 +0100 +@@ -79,7 +79,7 @@ + .so ../ers/ers.macros + .Ig + .Sh NAME +-pbs_terminate - terminate a pbs batch server ++pbs_terminate \- terminate a pbs batch server + .Sh SYNOPSIS + #include + .br +diff -urNad torque-2.1.8~/doc/man3/rpp.3 torque-2.1.8/doc/man3/rpp.3 +--- torque-2.1.8~/doc/man3/rpp.3 2006-10-13 20:25:44.000000000 +0200 ++++ torque-2.1.8/doc/man3/rpp.3 2008-01-14 14:56:56.000000000 +0100 +@@ -231,14 +231,14 @@ + .B rpp_poll(\|) + returns the stream identifier of a stream with data to read. If + no stream is ready to read, +-a -2 is returned. A -1 is returned if an error occurs. ++a \-2 is returned. A \-1 is returned if an error occurs. + .LP + .B rpp_io(\|) + processes any packets which are waiting to be sent or resceived over + the UDP socket. This routine should be called if a section of code + could be executing for more than a few (~10) seconds without calling + any other rpp function. +-A -1 is returned if an error occurs, 0 otherwise. ++A \-1 is returned if an error occurs, 0 otherwise. + .LP + .B rpp_read(\!) + transfers up to +@@ -250,7 +250,7 @@ + If all of a message has been read, the return value will be less than + .IR len . + The return value could be zero if all of a message had previously been +-read. A -1 is returned on error. A -2 is returned if the peer has ++read. A \-1 is returned on error. A \-2 is returned if the peer has + closed its connection. + If + .B rpp_poll(\!) +@@ -268,14 +268,14 @@ + .IR len + characters is transfered to the stream. + The number of characters added to the +-stream are returned or a -1 on error. In this case, errno will be set. +-A -2 is returned if the peer has closed its connection. ++stream are returned or a \-1 on error. In this case, errno will be set. ++A \-2 is returned if the peer has closed its connection. + .LP + .B rpp_close(\!) + disconnects the + .IR stream + from its peer and frees all resources associated with the stream. +-The return value is -1 on error and 0 otherwise. ++The return value is \-1 on error and 0 otherwise. + .B rpp_getaddr(\!) + returns the address which a + .IR stream +@@ -289,7 +289,7 @@ + .IR stream . + A zero is returned if the message + has been successfully committed. +-A -1 is returned on error. ++A \-1 is returned on error. + .LP + .B rpp_terminate(\!) + is used to free all memory associated with all streams and close the +diff -urNad torque-2.1.8~/doc/man3/tm.3 torque-2.1.8/doc/man3/tm.3 +--- torque-2.1.8~/doc/man3/tm.3 2006-10-13 20:25:44.000000000 +0200 ++++ torque-2.1.8/doc/man3/tm.3 2008-01-14 14:57:31.000000000 +0100 +@@ -299,7 +299,7 @@ + .IP tm_ntasks 20 + This will always be 0 for PBS. + .IP tm_taskpoolid 20 +-PBS does not support task pools so this will always be -1. ++PBS does not support task pools so this will always be \-1. + .IP tm_tasklist 20 + This will be NULL for PBS. + .LP +diff -urNad torque-2.1.8~/doc/man8/pbs_mom.8B torque-2.1.8/doc/man8/pbs_mom.8B +--- torque-2.1.8~/doc/man8/pbs_mom.8B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man8/pbs_mom.8B 2008-01-14 14:56:13.000000000 +0100 +@@ -117,20 +117,20 @@ + .IP "-C chkdirectory" 16 + Specifieds the path of the directory used to hold checkpoint files. + [Currently this is only valid on Cray systems.] +-The default directory is PBS_HOME/spool/checkpoint, see the -d option. +-The directory specified with the -C option must be owned by root and ++The default directory is PBS_HOME/spool/checkpoint, see the \-d option. ++The directory specified with the \-C option must be owned by root and + accessible (rwx) only by root to protect the security of the checkpoint files. + .IP "-c config" 16 + Specify a alternative configuration file, see description below. + If this is a relative file name it will be relative to PBS_HOME/mom_priv, +-see the -d option. If the specified file cannot be opened, pbs_mom will abort. +-If the -c option is not supplied, pbs_mom will attempt to open the default ++see the \-d option. If the specified file cannot be opened, pbs_mom will abort. ++If the \-c option is not supplied, pbs_mom will attempt to open the default + configuration file "config" in PBS_HOME/mom_priv. If this file is not + present, pbs_mom will log the fact and continue. + .IP "-d directory" 16 + Specifies the path of the directory which is the home of the servers + working files, PBS_HOME. +-This option is typically used along with -M when debugging MOM. ++This option is typically used along with \-M when debugging MOM. + The default directory is given by $PBS_SERVER_HOME + which is typically + .Ty /usr/spool/PBS . +@@ -139,7 +139,7 @@ + If not specified, MOM will + open a file named for the current date in the PBS_HOME/mom_logs + directory, see the +-.At -d ++.At \-d + option. + .IP "-M port" 16 + Specifies the port number on which the mini-server (MOM) will +@@ -153,26 +153,26 @@ + shut down. On any restart of MOM, the new mini-server will not be the + parent of any running jobs, MOM has lost control of her offspring (not a new + situation for a mother). +-With the -p option, Mom will allow the jobs to continue to run and ++With the \-p option, Mom will allow the jobs to continue to run and + monitor them indirectly via polling. +-The -p option is mutually exclusive with the -r option. ++The \-p option is mutually exclusive with the \-r option. + .IP "-r" 16 + Specifies the impact on jobs which were in execution when the mini-server +-shut down. With the -r option, ++shut down. With the \-r option, + MOM will kill any processes belonging to jobs, mark the jobs as terminated, + and notify the batch server which owns the job. +-The -r option is mutual exclusive with the -p option. ++The \-r option is mutual exclusive with the \-p option. + .IP + Normally the mini-server is started from the system boot file + without the +-.At -p ++.At \-p + or the +-.At -r ++.At \-r + option. The mini-server will make no attempt to signal the + former session of any job which may have been running when the mini-server + terminated. It is assumed that on reboot, all processes have been killed. + .IP +-If the -r option is used following a reboot, ++If the \-r option is used following a reboot, + process IDs (pids) may be reused and + MOM may kill a process that is not a batch session. + .IP "-a alarm" 16 +@@ -188,7 +188,7 @@ + .LP + .Sh CONFIGURATION FILE + The configuration file may be specified on the command line at +-program start with the -c flag. The use of this file is ++program start with the \-c flag. The use of this file is + to provide several types of run time information to pbs_mom: + static resource names and values, external resources provided + by a program to be run on request via a shell escape, and values +@@ -235,7 +235,7 @@ + .IP size[fs=] + Specifies that the available and configured disk space in the filesystem + is to be reported to the pbs_server and scheduler. NOTE: To request disk space +-on a per job basis, specify the file resource as in 'qsub -l ++on a per job basis, specify the file resource as in 'qsub \-l + nodes=1,file=1000kb' For example, the available and configured disk space in + the /localscratch filesystem will be reported: + .IP +@@ -376,9 +376,9 @@ + the command and the switches. The copy command must be able to recursively copy files to + the remote host and accept arguments of the form "user@host:files" For example: + .IP +-.Ty "$rcpcmd /usr/bin/rcp -rp ++.Ty "$rcpcmd /usr/bin/rcp \-rp + .br +-.Ty "$rcpcmd /usr/bin/scp -rpB ++.Ty "$rcpcmd /usr/bin/scp \-rpB + .IP timeout + Specifies the number of seconds before TCP messages will time out. TCP messages include job obituaries, and TM requests if RPP is disabled. + Default is 60 seconds. +@@ -405,7 +405,7 @@ + group id less than 10 and not be world writtable. + .LP + .Sh RESOURCES +-Resource Monitor queries can be made with momctl's -q option to retrieve and ++Resource Monitor queries can be made with momctl's \-q option to retrieve and + set pbs_mom options. Any configured static resource may be retrieved with a + request of the same name. These are resource requests not otherwise documented + in the PBS ERS. +@@ -425,7 +425,7 @@ + retrieve or set the $loglevel parameter + .IP down_on_error + retrieve or set the EXPERIMENTAL $down_on_error parameter +-.IP "diag0 - diag4" ++.IP "diag0 \- diag4" + retrieves various diagnostic information + .IP rcpcmd + retrieve or set the $rcpcmd parameter +diff -urNad torque-2.1.8~/doc/man8/pbs_sched_basl.8B torque-2.1.8/doc/man8/pbs_sched_basl.8B +--- torque-2.1.8~/doc/man8/pbs_sched_basl.8B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man8/pbs_sched_basl.8B 2008-01-14 14:56:13.000000000 +0100 +@@ -105,18 +105,18 @@ + .IP "-d home" + Specifies the name of the PBS home directory, PBS_HOME. + If not specified, the value +-of $PBS_SERVER_HOME as defined at compile time is used. Also see the -L ++of $PBS_SERVER_HOME as defined at compile time is used. Also see the \-L + option. + .IP "-L logfile" 5 + Specifies an absolute path name of the file to use as the log file. + If not specified, the scheduler will + open a file named for the current date in the PBS_HOME/sched_logs directory. +-See the -d option. ++See the \-d option. + .IP "-p print_file" 5 + This specifies the "print" file. Any output from the scheduler code which is + written to standard out or standard error will be written to this file. + If this option is not given, the file used will be +-$PBS_HOME/sched_priv/sched_out. See the -d option. ++$PBS_HOME/sched_priv/sched_out. See the \-d option. + .IP "-a alarm" 5 + This specifies the time in seconds to wait for a schedule run to finish. If a + scheduling iteration takes too long to finish, an alarm signal is sent, and +@@ -128,8 +128,8 @@ + required. It merely overides the default PBS scheduler port. + .IP "-c configfile" 5 + Specify a configuration file, see description below. If this is a relative +-file name it will be relative to PBS_HOME/sched_priv, see the -d option. +-If the -c option is not supplied, pbs_sched will not attempt to open a ++file name it will be relative to PBS_HOME/sched_priv, see the \-d option. ++If the \-c option is not supplied, pbs_sched will not attempt to open a + configuration file. In BASL, this config file is almost always needed because + it is where the list of servers, nodes, and host resource queries are specified by the administrator. + .LP +@@ -195,7 +195,7 @@ + For a more complete discussion of the Batch Scheduler Language, see + .B "basl2c(1B)". + .Sh CONFIGURATION FILE +-A configuration file may be specified with the -c option. ++A configuration file may be specified with the \-c option. + This file is used to specify the (1) hosts which are allowed to + connect to pbs_sched, (2) the list of server hosts for which the scheduler + writer wishes the system to periodically check for status, queues, and jobs +@@ -236,7 +236,7 @@ + is 0, then the default PBS server port will be used. + .sp + Regardless of what has been specified in the file, the list of servers +-will always include the local server - one running on the same host where ++will always include the local server \- one running on the same host where + the scheduler is running. + .sp + Within the BASL code, access to data of the list of servers is done by calling +diff -urNad torque-2.1.8~/doc/man8/pbs_sched_cc.8B torque-2.1.8/doc/man8/pbs_sched_cc.8B +--- torque-2.1.8~/doc/man8/pbs_sched_cc.8B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man8/pbs_sched_cc.8B 2008-01-14 14:56:13.000000000 +0100 +@@ -112,7 +112,7 @@ + Specifies an absolute path name of the file to use as the log file. + If not specified, the scheduler will + open a file named for the current date in the PBS_HOME/sched_logs +-directory (see the -d option). ++directory (see the \-d option). + .IP "-p file" 15 + This specifies the "print" file. Any output from the C + code which is written to standard out or standard error will be +@@ -120,7 +120,7 @@ + If this option is not given, the file used will be + .I PBS_HOME/sched_priv/sched_out . + See the +-.At -d ++.At \-d + option. + .IP "-S port" 15 + This specifies the port to use. If this option is not given, +@@ -132,7 +132,7 @@ + .IP "-c file" 15 + Specify a configuration file, see description below. + If this is a relative file name it will be relative to PBS_HOME/sched_priv, +-see the -d option. If the -c option is not supplied, pbs_sched will not ++see the \-d option. If the \-c option is not supplied, pbs_sched will not + attempt to open a configuration file. + .LP + The options that specify file names may be absolute or relative. +@@ -158,12 +158,12 @@ + .LP + If the processing takes more than the allotted time, the scheduler + will restart itself. The default amount of time is three minutes. This +-can be changed with the -a option. ++can be changed with the \-a option. + .LP + On receipt of a SIGHUP signal, the scheduler will close and reopen + its log file and reread its configuration file (if any). + .Sh CONFIGURATION FILE +-A configuration file may be specified with the -c option. ++A configuration file may be specified with the \-c option. + This file may be used to specify the hosts (servers) which are allowed to + connect to pbs_sched. The hosts are specified in the configuration file + in a manor identical to that used in pbs_mom. +diff -urNad torque-2.1.8~/doc/man8/pbs_sched_tcl.8B torque-2.1.8/doc/man8/pbs_sched_tcl.8B +--- torque-2.1.8~/doc/man8/pbs_sched_tcl.8B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man8/pbs_sched_tcl.8B 2008-01-14 14:56:13.000000000 +0100 +@@ -124,7 +124,7 @@ + Specifies an absolute path name of the file to use as the log file. + If not specified, the scheduler will + open a file named for the current date in the PBS_HOME/sched_logs +-directory (see the -d option). ++directory (see the \-d option). + .IP "-p file" 15 + This specifies the "print" file. Any output from the Tcl + code which is written to standard out or standard error will be +@@ -132,7 +132,7 @@ + If this option is not given, the file used will be + .I PBS_HOME/sched_priv/sched_out. + See the +-.At -d ++.At \-d + option. + .IP "-S port" 15 + This specifies the port to use. If this option is not given, +@@ -149,7 +149,7 @@ + .IP "-c file" 15 + Specify a configuration file, see description below. + If this is a relative file name it will be relative to PBS_HOME/sched_priv, +-see the -d option. If the -c option is not supplied, pbs_sched will not ++see the \-d option. If the \-c option is not supplied, pbs_sched will not + attempt to open a configuration file. + .LP + The options that specify file names may be absolute or relative. +@@ -475,7 +475,7 @@ + is called first. The "body" file is run with a connection to + the server already established. + .Sh CONFIGURATION FILE +-A configuration file may be specified with the -c option. ++A configuration file may be specified with the \-c option. + This file may be used to specify the hosts (servers) which are allowed to + connect to pbs_sched. The hosts are specified in the configuration file + in a manor identical to that used in pbs_mom. There is one line per +diff -urNad torque-2.1.8~/doc/man8/pbs_server.8B torque-2.1.8/doc/man8/pbs_server.8B +--- torque-2.1.8~/doc/man8/pbs_server.8B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man8/pbs_server.8B 2008-01-14 14:56:13.000000000 +0100 +@@ -136,7 +136,7 @@ + Specifies an absolute path name of the file to use as the log file. + If not specified, the file is one named for the current date in the + PBS_HOME/server_logs directory, see the +-.At -d ++.At \-d + option. + .IP "-M mom_port" + Specifies the host name and/or port number on which the server should connect +@@ -144,15 +144,15 @@ + .Ar mom_conn , + is one of the forms: host_name, [:]port_number, or host_name:port_number. + If host_name not specified, the local host is assumed. If port_number is not +-specified, the default port is assumed. See the -M option for pbs_mom(8). ++specified, the default port is assumed. See the \-M option for pbs_mom(8). + .IP "-R mom_RPPport" + Specifies the port number on which the the server should query the up/down +-status of Mom. See the -R option for pbs_mom(8). ++status of Mom. See the \-R option for pbs_mom(8). + .IP "-S scheduler_port" 15 + Specifies the port number to which the server should connect when + contacting the Scheduler. The option argument, + .Ar scheduler_conn , +-is of the same syntax as under the -M option. ++is of the same syntax as under the \-M option. + +.IP "-h hostname" + Causes the server to start under a different hostname as obtained from + gethostname(2). Useful for servers with multiple network interfaces to support +@@ -182,7 +182,7 @@ + .IP warm 8 + All rerunnable jobs which were running when the server went down are requeued. + All other jobs are maintained. New selections are made for which +-jobs are placed into execution. Warm is the default if -t is not specified. ++jobs are placed into execution. Warm is the default if \-t is not specified. + .IP cold 8 + All jobs are deleted. Positive confirmation is required before + this direction is accepted. +diff -urNad torque-2.1.8~/doc/man8/pbsnodes.8B torque-2.1.8/doc/man8/pbsnodes.8B +--- torque-2.1.8~/doc/man8/pbsnodes.8B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man8/pbsnodes.8B 2008-01-14 14:56:13.000000000 +0100 +@@ -128,6 +128,6 @@ + .IP "-s" 15 + Specify the PBS server's hostname or IP address. + .IP "-x" 15 +-Same as -a, but the output has an XML-like format. ++Same as \-a, but the output has an XML-like format. + .Sh SEE ALSO + pbs_server(8B) and the PBS External Reference Specification +diff -urNad torque-2.1.8~/doc/man8/qterm.8B torque-2.1.8/doc/man8/qterm.8B +--- torque-2.1.8~/doc/man8/qterm.8B 2008-01-11 02:49:48.000000000 +0100 ++++ torque-2.1.8/doc/man8/qterm.8B 2008-01-14 14:56:13.000000000 +0100 +@@ -133,7 +133,7 @@ + Normally the server will not shutdown until there are no jobs in the running + state. If the server is unable to contact the MOM of running job, the job + is still listed as running. +-The server may be forced down by a second \*Qqterm -t immediate\*U ++The server may be forced down by a second \*Qqterm \-t immediate\*U + command. + .IP delay\ + If checkpoint is supported, running jobs that can be checkpointed are --- torque-2.1.8+dfsg.orig/debian/patches/02-man8.dpatch +++ torque-2.1.8+dfsg/debian/patches/02-man8.dpatch @@ -0,0 +1,18 @@ +#! /bin/sh /usr/share/dpatch/dpatch-run +## pbs_mom.dpatch by Morten Kjeldgaard +## +## DP: Fix nroff warning + +@DPATCH@ +diff -urNad torque~/doc/man8/pbs_mom.8B torque/doc/man8/pbs_mom.8B +--- torque~/doc/man8/pbs_mom.8B 2008-02-09 18:29:04.000000000 +0100 ++++ torque/doc/man8/pbs_mom.8B 2008-02-09 18:30:28.000000000 +0100 +@@ -480,7 +480,7 @@ + results in pbs_mom exiting without terminating any running jobs. + This is the action for the following signals as well: SIGXCPU, SIGXFSZ, + SIGCPULIM, and SIGSHUTDN. +-.IP SIGUSR1, SIGUSR2 ++.IP "SIGUSR1, SIGUSR2" + causes mom to increase and decrease logging levels, respectively. + .IP "SIGPIPE, SIGINFO" + are ignored. --- torque-2.1.8+dfsg.orig/debian/patches/01-man1.dpatch +++ torque-2.1.8+dfsg/debian/patches/01-man1.dpatch @@ -0,0 +1,110 @@ +#! /bin/sh /usr/share/dpatch/dpatch-run +## 01-man1.dpatch by Morten Kjeldgaard +## +## DP: Fix formatting issues in basl2c.1B and xpbsmon.1B + +@DPATCH@ +--- doc/man1/basl2c.1B.orig 2008-02-09 19:30:27.000000000 +0100 ++++ foo/doc/man1/basl2c.1B 2008-02-09 20:32:07.000000000 +0100 +@@ -1414,9 +1414,11 @@ + with values that are of Int type. Sample resource names + are: cput, pcput, walltime, mppt, pmppt, nice, procs, mppe, ncpus, + pncpus, nodect, srfs_assist, mta,..., mth. For a description of these ++.na + resource names, see pbs_resources_irix5(7B), pbs_resources_sp2(7B), + pbs_resources_sunos4(7B), pbs_resources_unicos8(7B), pbs_server_attributes(7B), + pbs_resources_irix6(7B), pbs_resources_linux(7B). ++.ad + .sp + Example: + .Ty +@@ -1626,11 +1628,13 @@ + .At resources_available.name + attribute). Call this function for resources + with values that are of Int type. Sample resource names ++.na + are: cput, pcput, walltime, mppt, pmppt, nice, procs, mppe, ncpus, + pncpus, nodect, srfs_assist, mta,..., mth. For a description of these + resource names, see pbs_resources_irix5(7B), pbs_resources_sp2(7B), + pbs_resources_sunos4(7B), pbs_resources_unicos8(7B), pbs_server_attributes(7B), + pbs_resources_irix6(7B), pbs_resources_linux(7B). ++.ad + .IP "\f3Size QueSizeResAvailGet(Que q, String name)\f1" + Returns the value to resource specified in + .B name +@@ -1640,9 +1644,11 @@ + with values that are of Size type. Sample resource names + are: file, mem, pmem, workingset, pf, ppf, srfs_tmp, srfs_wrk, srfs_big, + srfs_fast, sds, psds. For a description of these ++.na + resource names, see pbs_resources_irix5(7B), pbs_resources_sp2(7B), + pbs_resources_sunos4(7B), pbs_resources_unicos8(7B), pbs_server_attributes(7B), + pbs_resources_irix6(7B), pbs_resources_linux(7B). ++.ad + .IP "\f3String QueStringResAvailGet(Que q, String name)\f1" + Returns the value to resource specified in + .B name +@@ -1651,9 +1657,11 @@ + attribute). Call this function for resources + with values that are of String type. Sample resource names + are: nodes, arch, neednodes. For a description of these resource names, see ++.na + pbs_resources_irix5(7B), pbs_resources_sp2(7B), + pbs_resources_sunos4(7B), pbs_resources_unicos8(7B), pbs_server_attributes(7B), + pbs_resources_irix6(7B), pbs_resources_linux(7B). ++.ad + .IP "\f3Int QueIntResAssignGet(Que q, String name)\f1" + Returns the value to resource specified in + .B name +@@ -1686,9 +1694,11 @@ + attribute). Call this function for resources + with values that are of String type. Sample resource names + are: nodes, arch, neednodes. For a description of these resource names, see ++.na + pbs_resources_irix5(7B), pbs_resources_sp2(7B), + pbs_resources_sunos4(7B), pbs_resources_unicos8(7B), pbs_server_attributes(7B), + pbs_resources_irix6(7B), pbs_resources_linux(7B). ++.ad + .RE + .IP "(3) Job-related functions" + .RS +@@ -1757,9 +1767,11 @@ + with values that are of Size type. Sample resource names + are: file, mem, pmem, workingset, pf, ppf, srfs_tmp, srfs_wrk, srfs_big, + srfs_fast, sds, psds. For a description of these ++.na + resource names, see pbs_resources_irix5(7B), pbs_resources_sp2(7B), + pbs_resources_sunos4(7B), pbs_resources_unicos8(7B), pbs_server_attributes(7B), + pbs_resources_irix6(7B), pbs_resources_linux(7B). ++.ad + .sp + Example: + .Ty +@@ -1818,9 +1830,11 @@ + with values that are of Size type. Sample resource names + are: file, mem, pmem, workingset, pf, ppf, srfs_tmp, srfs_wrk, srfs_big, + srfs_fast, sds, psds. For a description of these ++.na + resource names, see pbs_resources_irix5(7B), pbs_resources_sp2(7B), + pbs_resources_sunos4(7B), pbs_resources_unicos8(7B), pbs_server_attributes(7B), + pbs_resources_irix6(7B), pbs_resources_linux(7B). ++.ad + .sp + Example: + .Ty +--- doc/man1/xpbsmon.1B.orig 2008-02-09 20:26:10.000000000 +0100 ++++ foo/doc/man1/xpbsmon.1B 2008-02-09 20:32:24.000000000 +0100 +@@ -613,11 +613,13 @@ + the separator character for each input within a curly-bracketed line of + input of *siteInfo. + .IP *sitesInfo ++.na + {} + .br + . . . + .br + {} ++.ad + .sp + information about a site where can be either {FULL,ICON}, + can be {MOM, NOMOM}, and has the format: --- torque-2.1.8+dfsg.orig/debian/patches/00list +++ torque-2.1.8+dfsg/debian/patches/00list @@ -0,0 +1,3 @@ +01-man1.dpatch +02-man8.dpatch +03-fixhyphens.dpatch --- torque-2.1.8+dfsg.orig/debian/torque-pam.install +++ torque-2.1.8+dfsg/debian/torque-pam.install @@ -0,0 +1 @@ +debian/tmp/lib/security/pam_pbssimpleauth.so --- torque-2.1.8+dfsg.orig/debian/torque-base.install +++ torque-2.1.8+dfsg/debian/torque-base.install @@ -0,0 +1,2 @@ +debian/tmp/var/lib/torque/pbs_environment +debian/tmp/var/lib/torque/server_name --- torque-2.1.8+dfsg.orig/debian/README.html +++ torque-2.1.8+dfsg/debian/README.html @@ -0,0 +1,426 @@ + + + + + + +Short and incomplete pointers to setting up the torque batch system + + + +
+
+

The default torque server name is "torqueserver". This name is defined in +the file /var/lib/torque/server_name. You can either change this, or, if +you have access to the nameserver, add a torqueserver CNAME record pointing +to the actual machine.

+

I will describe a simple setup, where we have a head node, that +does not itself act as a computing server. Submitted jobs will be +executed on the compute nodes.

+

In our setup, users have their root on NFS mounted shares, that are +accesible from all workstations and also the compute nodes (via autofs).

+

For the system to work smoothly, it is important that you have set up +passwordless ssh, so compute nodes can copy the batch queue log files back +to the users' disk area.

+
+
+

Head node

+
+

On the head node, you need to run the torque-server and torque-scheduler. +The scheduler is a simple one, you can substitute it with a more +sophisticated one like maui, also distributed from +clusterressources.org (unfortunately, maui +has a license too strict to distribute as packages.)

+
+

Compute node

+
+

On each of the compute nodes, you need to install at least torque-mom.

+
+

Submit hosts

+
+

You also need a number of submit hosts, that may or may not include the +head and compute nodes. On these, you need to install the software in +torque-client. In our case, users do their work on a desktop workstation in +their offices or in the computing room. You can submit jobs from each of +these, these jobs are forwarded to the head node (torque-server) and there +scheduled for execution.

+
+

Add to /etc/services

+
+

If you want to have names associated with the ports that are used by +torque, you may want to patch /etc/services:

+
+
+
#(torque
+# Standard PBS services
+pbs           15001/tcp           # pbs server (pbs_server)
+pbs           15001/udp           # pbs server (pbs_server)
+pbs_mom       15002/tcp           # mom to/from server
+pbs_mom       15002/udp           # mom to/from server
+pbs_resmom    15003/tcp           # mom resource management requests
+pbs_resmom    15003/udp           # mom resource management requests
+pbs_sched     15004/tcp           # scheduler
+pbs_sched     15004/udp           # scheduler
+#)
+
+

If you ever need to remove this entry again, run this script:

+
+
+
tmp=`mktemp -p/tmp`
+target=/etc/services
+
+
+
+
grep -q '#(torque' $target || exit
+echo -n "unpatching $target... "
+sed -r '/#\(torque/,/#\)/d' < $target > $tmp
+cp $tmp $target
+rm -f $tmp
+echo done
+
+
+

Create a batch server on localhost

+
+

You can run a batch server on a single host. This can be useful if you +want to try out the software, or if you regularly run many jobs and +you need some way of keeping track of them.

+

You need to install several of the packages:

+
+
+
sudo apt-get install torque-mom torque-server torque-client torque-scheduler
+
+

and then run the following script (as root)

+
+
+
#! /bin/sh
+update-rc.d pbs_mom defaults
+update-rc.d pbs_server defaults
+update-rc.d pbs_sched defaults
+hostname --long > /var/lib/torque/server_priv/nodes
+hostname --long > /var/lib/torque/server_name
+hostname --long > /var/lib/torque/mom_priv/config
+pbs_server -t create
+qmgr -c "s s scheduling=true"
+qmgr -c "c q batch queue_type=execution"
+qmgr -c "s q batch started=true"
+qmgr -c "s q batch enabled=true"
+qmgr -c "s q batch resources_default.nodes=1"
+qmgr -c "s q batch resources_default.walltime=3600"
+qmgr -c "s s default_queue=batch"
+invoke-rc.d restart
+invoke-rc.d restart
+invoke-rc.d restart
+qmgr -c "s n `/bin/hostname --long` state=free" -e
+
+

and enjoy your very own batch server!

+
+
+
-- Morten Kjeldgaard <mok@bioxray.au.dk>, Sat,  9 Feb 2008 23:01:19 +0100
+
+
+ + + --- torque-2.1.8+dfsg.orig/debian/torque-mom.dirs +++ torque-2.1.8+dfsg/debian/torque-mom.dirs @@ -0,0 +1,4 @@ +/var/lib/torque/mom_priv +/var/lib/torque/mom_logs +/var/lib/torque/checkpoint +/var/lib/torque/undelivered --- torque-2.1.8+dfsg.orig/debian/torque-mom.manpages +++ torque-2.1.8+dfsg/debian/torque-mom.manpages @@ -0,0 +1 @@ +debian/tmp/usr/share/man/man8/pbs_mom.8 --- torque-2.1.8+dfsg.orig/debian/torque-base.docs +++ torque-2.1.8+dfsg/debian/torque-base.docs @@ -0,0 +1,4 @@ +README.torque +torque.setup +Release_Notes +debian/README.html --- torque-2.1.8+dfsg.orig/debian/torque-dev.manpages +++ torque-2.1.8+dfsg/debian/torque-dev.manpages @@ -0,0 +1,29 @@ +debian/tmp/usr/share/man/man3/rpp.3 +debian/tmp/usr/share/man/man3/tm.3 +debian/tmp/usr/share/man/man3/pbs_alterjob.3 +debian/tmp/usr/share/man/man3/pbs_connect.3 +debian/tmp/usr/share/man/man3/pbs_default.3 +debian/tmp/usr/share/man/man3/pbs_deljob.3 +debian/tmp/usr/share/man/man3/pbs_disconnect.3 +debian/tmp/usr/share/man/man3/pbs_geterrmsg.3 +debian/tmp/usr/share/man/man3/pbs_holdjob.3 +debian/tmp/usr/share/man/man3/pbs_locate.3 +debian/tmp/usr/share/man/man3/pbs_manager.3 +debian/tmp/usr/share/man/man3/pbs_movejob.3 +debian/tmp/usr/share/man/man3/pbs_msgjob.3 +debian/tmp/usr/share/man/man3/pbs_orderjob.3 +debian/tmp/usr/share/man/man3/pbs_rerunjob.3 +debian/tmp/usr/share/man/man3/pbs_rescquery.3 +debian/tmp/usr/share/man/man3/pbs_rescreserve.3 +debian/tmp/usr/share/man/man3/pbs_rlsjob.3 +debian/tmp/usr/share/man/man3/pbs_runjob.3 +debian/tmp/usr/share/man/man3/pbs_selectjob.3 +debian/tmp/usr/share/man/man3/pbs_selstat.3 +debian/tmp/usr/share/man/man3/pbs_sigjob.3 +debian/tmp/usr/share/man/man3/pbs_stagein.3 +debian/tmp/usr/share/man/man3/pbs_statjob.3 +debian/tmp/usr/share/man/man3/pbs_statnode.3 +debian/tmp/usr/share/man/man3/pbs_statque.3 +debian/tmp/usr/share/man/man3/pbs_statserver.3 +debian/tmp/usr/share/man/man3/pbs_submit.3 +debian/tmp/usr/share/man/man3/pbs_terminate.3 --- torque-2.1.8+dfsg.orig/debian/torque-pam.docs +++ torque-2.1.8+dfsg/debian/torque-pam.docs @@ -0,0 +1 @@ +src/pam/README.pam --- torque-2.1.8+dfsg.orig/debian/torque-dev.install +++ torque-2.1.8+dfsg/debian/torque-dev.install @@ -0,0 +1,4 @@ +debian/tmp/usr/bin/pbs-config +debian/tmp/usr/lib/libtorque.a +debian/tmp/usr/lib/libtorque.so +debian/tmp/usr/include/ --- torque-2.1.8+dfsg.orig/debian/libtorque0.install +++ torque-2.1.8+dfsg/debian/libtorque0.install @@ -0,0 +1,2 @@ +debian/tmp/usr/lib/libtorque.so.0 +debian/tmp/usr/lib/libtorque.so.0.0.0 --- torque-2.1.8+dfsg.orig/debian/rules +++ torque-2.1.8+dfsg/debian/rules @@ -0,0 +1,89 @@ +#!/usr/bin/make -f +# -*- mode: makefile; mode: font-lock -*- + +include /usr/share/cdbs/1/rules/debhelper.mk +include /usr/share/cdbs/1/class/autotools.mk +include /usr/share/cdbs/1/rules/dpatch.mk + +# cdbs silently drops upstream changelog from all packages: +DEB_INSTALL_CHANGELOGS_ALL = CHANGELOG + +# I can't use tcl/tk/tclx version 8.4, because +# the configure script wants to use tclxConfig.sh which no +# longer exists in tclX 8.4. Furthermore, configure has +# no way to set the tclX include directory, so I have to modify +# CFLAGS. Yuck. + +ifeq ($(DEB_BUILD_ARCH),amd64) + CFLAGS += -m64 +endif + +DEB_CONFIGURE_EXTRA_FLAGS=--prefix=/usr \ + --mandir=/usr/share/man \ + --includedir=/usr/include/torque \ + --with-server-home=/var/lib/torque \ + --with-pam=/lib/security \ + --with-default-server=torqueserver \ + --with-tk=/usr/lib/tk8.3 \ + --with-tcl=/usr/lib/tcl8.3 \ + --with-tclx=/usr/lib/tclX8.3 \ + --enable-gui --enable-syslog --enable-rpp --with-rcp=scp \ + CFLAGS="-I/usr/include/tclX8.3 $(CFLAGS) -DWISH_PROG=/usr/bin/wish8.3" LDFLAGS="-Wl,-z,defs" + +DEB_FIXPERMS_EXCLUDE=/usr/sbin/pbs_iff + +install/torque-server:: + chrpath -d debian/tmp/usr/sbin/momctl + chrpath -d debian/tmp/usr/sbin/pbs_server + +install/torque-scheduler:: + chrpath -d debian/tmp/usr/sbin/pbs_sched + +install/torque-gui:: + chrpath -d debian/tmp/usr/bin/pbs_wish + +install/torque-mom:: + chrpath -d debian/tmp/usr/sbin/pbs_mom + +install/torque-client:: + chrpath -d debian/tmp/usr/bin/chk_tree + chrpath -d debian/tmp/usr/bin/hostn + chrpath -d debian/tmp/usr/bin/pbs_tclsh + chrpath -d debian/tmp/usr/bin/pbsdsh + chrpath -d debian/tmp/usr/bin/pbsnodes + chrpath -d debian/tmp/usr/bin/printjob + chrpath -d debian/tmp/usr/bin/printtracking + chrpath -d debian/tmp/usr/bin/qalter + chrpath -d debian/tmp/usr/bin/qdel + chrpath -d debian/tmp/usr/bin/qdisable + chrpath -d debian/tmp/usr/bin/qenable + chrpath -d debian/tmp/usr/bin/qhold + chrpath -d debian/tmp/usr/bin/qmgr + chrpath -d debian/tmp/usr/bin/qmove + chrpath -d debian/tmp/usr/bin/qmsg + chrpath -d debian/tmp/usr/bin/qorder + chrpath -d debian/tmp/usr/bin/qrerun + chrpath -d debian/tmp/usr/bin/qrls + chrpath -d debian/tmp/usr/bin/qrun + chrpath -d debian/tmp/usr/bin/qselect + chrpath -d debian/tmp/usr/bin/qsig + chrpath -d debian/tmp/usr/bin/qstart + chrpath -d debian/tmp/usr/bin/qstat + chrpath -d debian/tmp/usr/bin/qstop + chrpath -d debian/tmp/usr/bin/qsub + chrpath -d debian/tmp/usr/bin/qterm + chrpath -d debian/tmp/usr/bin/tracejob + chrpath -d debian/tmp/usr/sbin/pbs_demux + chrpath -d debian/tmp/usr/sbin/pbs_iff + install -D -m 644 debian/torque-client.lintian debian/tmp/usr/share/lintian/overrides/torque-client + +get-orig-source: + mkdir ../xxx + cd ../xxx; wget http://www.clusterresources.com/downloads/torque/torque-2.1.8.tar.gz + cd ../xxx; tar -xzf torque-2.1.8.tar.gz + mv ../xxx/torque-2.1.8/ ../xxx/torque-2.1.8.orig + rm ../xxx/torque-2.1.8.orig/doc/admin_guide.ps + tar -C ../xxx -cf ../torque_2.1.8+dfsg.orig.tar torque-2.1.8.orig/ + gzip -9f ../torque_2.1.8+dfsg.orig.tar + rm -rf ../xxx/ +#### --- torque-2.1.8+dfsg.orig/debian/torque-scheduler.init +++ torque-2.1.8+dfsg/debian/torque-scheduler.init @@ -0,0 +1,79 @@ +#! /bin/sh +### BEGIN INIT INFO +# Provides: torque-scheduler +# Required-Start: $all +# Required-Stop: $all +# Should-Start: $all +# Should-Stop: $all +# Default-Start: 2 3 4 5 +# Default-Stop: 0 1 6 +# Short-Description: Start and stop the Torque scheduler +# Description: PBS is a versatile batch system for SMPs and clusters. +# This script controls the scheduler. +### END INIT INFO + +PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin +DAEMON=/usr/sbin/pbs_sched +NAME=torque-scheduler +DESC="Torque scheduler" + +test -x $DAEMON || exit 0 + +# Load lsb functions +. /lib/lsb/init-functions + +# Include defaults if available +if [ -f /etc/default/$NAME ] ; then + . /etc/default/$NAME +fi + +set -e + +case "$1" in + start) + log_begin_msg "Starting $DESC: " + start-stop-daemon --start --quiet --pidfile /var/run/$NAME.pid \ + --exec $DAEMON -- $DAEMON_OPTS + log_end_msg $? + ;; + stop) + log_begin_msg "Stopping $DESC: " + start-stop-daemon --stop --quiet --pidfile /var/run/$NAME.pid \ + --exec $DAEMON + log_end_msg $? + ;; + reload) + # send a SIGHUP to force scheduler to reload config file + log_begin_msg "Reloading $DESC configuration files." + start-stop-daemon --stop --signal 1 --quiet --pidfile \ + /var/run/$NAME.pid --exec $DAEMON + log_end_msg $? + ;; + force-reload) + # check whether $DAEMON is running. If so, restart + start-stop-daemon --stop --test --quiet --pidfile \ + /var/run/$NAME.pid --exec $DAEMON \ + && $0 restart \ + || exit 0 + ;; + restart) + log_begin_msg "Restarting $DESC: " + start-stop-daemon --stop --quiet --pidfile \ + /var/run/$NAME.pid --exec $DAEMON + sleep 1 + start-stop-daemon --start --quiet --pidfile \ + /var/run/$NAME.pid --exec $DAEMON -- $DAEMON_OPTS + log_end_msg $? + ;; + *) + N=/etc/init.d/$NAME + log_success_msg "Usage: $N {start|stop|restart|force-reload}" + exit 1 + ;; +esac + +exit 0 + +# Local variables: +# mode: font-lock +# End: --- torque-2.1.8+dfsg.orig/debian/torque-server.dirs +++ torque-2.1.8+dfsg/debian/torque-server.dirs @@ -0,0 +1,2 @@ +/var/lib/torque/server_logs +/var/lib/torque/server_priv --- torque-2.1.8+dfsg.orig/debian/torque-gui.install +++ torque-2.1.8+dfsg/debian/torque-gui.install @@ -0,0 +1,3 @@ +debian/tmp/usr/bin/pbs_wish +debian/tmp/usr/bin/xpbs +debian/tmp/usr/bin/xpbsmon --- torque-2.1.8+dfsg.orig/debian/torque-base.dirs +++ torque-2.1.8+dfsg/debian/torque-base.dirs @@ -0,0 +1,2 @@ +/var/lib/torque/aux +/var/lib/torque/spool --- torque-2.1.8+dfsg.orig/debian/torque-server.manpages +++ torque-2.1.8+dfsg/debian/torque-server.manpages @@ -0,0 +1 @@ +debian/tmp/usr/share/man/man8/pbs_server.8 --- torque-2.1.8+dfsg.orig/debian/torque-client.install +++ torque-2.1.8+dfsg/debian/torque-client.install @@ -0,0 +1,13 @@ +debian/tmp/usr/bin/q* +debian/tmp/usr/bin/chk_tree +debian/tmp/usr/bin/hostn +debian/tmp/usr/bin/nqs2pbs +debian/tmp/usr/bin/pbsdsh +debian/tmp/usr/bin/pbsnodes +debian/tmp/usr/bin/printjob +debian/tmp/usr/bin/printtracking +debian/tmp/usr/bin/tracejob +debian/tmp/usr/sbin/pbs_iff +debian/tmp/usr/sbin/pbs_demux +debian/tmp/usr/bin/pbs_tclsh +debian/tmp/usr/share/lintian/overrides/torque-client --- torque-2.1.8+dfsg.orig/debian/README.Debian +++ torque-2.1.8+dfsg/debian/README.Debian @@ -0,0 +1,113 @@ +Short and incomplete pointers to setting up the torque batch system +=================================================================== +Morten Kjeldgaard +January 2008 + +The default torque server name is "torqueserver". This name is defined in +the file `/var/lib/torque/server_name`. You can either change this, or, if +you have access to the nameserver, add a torqueserver CNAME record pointing +to the actual machine. + +I will describe a simple setup, where we have a head node, that +does not itself act as a computing server. Submitted jobs will be +executed on the compute nodes. + +In our setup, users have their root on NFS mounted shares, that are +accesible from all workstations and also the compute nodes (via autofs). + +For the system to work smoothly, it is important that you have set up +passwordless ssh, so compute nodes can copy the batch queue log files back +to the users' disk area. + +Head node +--------- + +On the head node, you need to run the torque-server and torque-scheduler. +The scheduler is a simple one, you can substitute it with a more +sophisticated one like maui, also distributed from +http://www.clusterresources.com/[clusterressources.org] (unfortunately, maui +has a license too strict to distribute as packages.) + +Compute node +------------ + +On each of the compute nodes, you need to install at least torque-mom. + +Submit hosts +------------ + +You also need a number of submit hosts, that may or may not include the +head and compute nodes. On these, you need to install the software in +torque-client. In our case, users do their work on a desktop workstation in +their offices or in the computing room. You can submit jobs from each of +these, these jobs are forwarded to the head node (torque-server) and there +scheduled for execution. + +Add to /etc/services +-------------------- + +If you want to have names associated with the ports that are used by +torque, you may want to patch /etc/services: + + + #(torque + # Standard PBS services + pbs 15001/tcp # pbs server (pbs_server) + pbs 15001/udp # pbs server (pbs_server) + pbs_mom 15002/tcp # mom to/from server + pbs_mom 15002/udp # mom to/from server + pbs_resmom 15003/tcp # mom resource management requests + pbs_resmom 15003/udp # mom resource management requests + pbs_sched 15004/tcp # scheduler + pbs_sched 15004/udp # scheduler + #) + +If you ever need to remove this entry again, run this script: + + tmp=`mktemp -p/tmp` + target=/etc/services + + grep -q '#(torque' $target || exit + echo -n "unpatching $target... " + sed -r '/#\(torque/,/#\)/d' < $target > $tmp + cp $tmp $target + rm -f $tmp + echo done + + +Create a batch server on localhost +---------------------------------- + +You can run a batch server on a single host. This can be useful if you +want to try out the software, or if you regularly run many jobs and +you need some way of keeping track of them. + +You need to install several of the packages: + + sudo apt-get install torque-mom torque-server torque-client torque-scheduler + +and then run the following script (as root) + + #! /bin/sh + update-rc.d pbs_mom defaults + update-rc.d pbs_server defaults + update-rc.d pbs_sched defaults + hostname --long > /var/lib/torque/server_priv/nodes + hostname --long > /var/lib/torque/server_name + hostname --long > /var/lib/torque/mom_priv/config + pbs_server -t create + qmgr -c "s s scheduling=true" + qmgr -c "c q batch queue_type=execution" + qmgr -c "s q batch started=true" + qmgr -c "s q batch enabled=true" + qmgr -c "s q batch resources_default.nodes=1" + qmgr -c "s q batch resources_default.walltime=3600" + qmgr -c "s s default_queue=batch" + invoke-rc.d restart + invoke-rc.d restart + invoke-rc.d restart + qmgr -c "s n `/bin/hostname --long` state=free" -e + +and enjoy your very own batch server! + + -- Morten Kjeldgaard , Sat, 9 Feb 2008 23:01:19 +0100 --- torque-2.1.8+dfsg.orig/debian/compat +++ torque-2.1.8+dfsg/debian/compat @@ -0,0 +1 @@ +5 --- torque-2.1.8+dfsg.orig/debian/torque-scheduler.install +++ torque-2.1.8+dfsg/debian/torque-scheduler.install @@ -0,0 +1 @@ +debian/tmp/usr/sbin/pbs_sched --- torque-2.1.8+dfsg.orig/debian/torque-gui.manpages +++ torque-2.1.8+dfsg/debian/torque-gui.manpages @@ -0,0 +1,2 @@ +debian/tmp/usr/share/man/man1/xpbs.1 +debian/tmp/usr/share/man/man1/xpbsmon.1 --- torque-2.1.8+dfsg.orig/debian/torque-client.lintian +++ torque-2.1.8+dfsg/debian/torque-client.lintian @@ -0,0 +1 @@ +torque-client: setuid-binary usr/sbin/pbs_iff 4755 root/root --- torque-2.1.8+dfsg.orig/debian/torque-server.install +++ torque-2.1.8+dfsg/debian/torque-server.install @@ -0,0 +1,2 @@ +debian/tmp/usr/sbin/pbs_server +debian/tmp/usr/sbin/momctl --- torque-2.1.8+dfsg.orig/debian/watch +++ torque-2.1.8+dfsg/debian/watch @@ -0,0 +1,2 @@ +version=3 +http://www.clusterresources.com/downloads/torque/torque-(.*)\.tar\.gz --- torque-2.1.8+dfsg.orig/debian/torque-client.manpages +++ torque-2.1.8+dfsg/debian/torque-client.manpages @@ -0,0 +1,47 @@ +debian/tmp/usr/share/man/man8/pbsnodes.8 +debian/tmp/usr/share/man/man1/qalter.1 +debian/tmp/usr/share/man/man1/qdel.1 +debian/tmp/usr/share/man/man1/qhold.1 +debian/tmp/usr/share/man/man1/qmove.1 +debian/tmp/usr/share/man/man1/qmsg.1 +debian/tmp/usr/share/man/man1/qorder.1 +debian/tmp/usr/share/man/man1/qrerun.1 +debian/tmp/usr/share/man/man1/qrls.1 +debian/tmp/usr/share/man/man1/qselect.1 +debian/tmp/usr/share/man/man1/qsig.1 +debian/tmp/usr/share/man/man1/qstat.1 +debian/tmp/usr/share/man/man1/qsub.1 +debian/tmp/usr/share/man/man1/pbs.1 +debian/tmp/usr/share/man/man1/pbsdsh.1 +debian/tmp/usr/share/man/man1/nqs2pbs.1 +debian/tmp/usr/share/man/man1/basl2c.1 +debian/tmp/usr/share/man/man1/qmgr.1 +debian/tmp/usr/share/man/man7/pbs_job_attributes.7 +debian/tmp/usr/share/man/man7/pbs_queue_attributes.7 +debian/tmp/usr/share/man/man7/pbs_server_attributes.7 +debian/tmp/usr/share/man/man7/pbs_resources_aix4.7 +debian/tmp/usr/share/man/man7/pbs_resources_digitalunix.7 +debian/tmp/usr/share/man/man7/pbs_resources_aix5.7 +debian/tmp/usr/share/man/man7/pbs_resources_darwin.7 +debian/tmp/usr/share/man/man7/pbs_resources_freebsd.7 +debian/tmp/usr/share/man/man7/pbs_resources_fujitsu.7 +debian/tmp/usr/share/man/man7/pbs_resources_hpux10.7 +debian/tmp/usr/share/man/man7/pbs_resources_irix5.7 +debian/tmp/usr/share/man/man7/pbs_resources_hpux11.7 +debian/tmp/usr/share/man/man7/pbs_resources_irix6.7 +debian/tmp/usr/share/man/man7/pbs_resources_irix6array.7 +debian/tmp/usr/share/man/man7/pbs_resources_linux.7 +debian/tmp/usr/share/man/man7/pbs_resources_netbsd.7 +debian/tmp/usr/share/man/man7/pbs_resources_solaris5.7 +debian/tmp/usr/share/man/man7/pbs_resources_solaris7.7 +debian/tmp/usr/share/man/man7/pbs_resources_sp2.7 +debian/tmp/usr/share/man/man7/pbs_resources_sunos4.7 +debian/tmp/usr/share/man/man7/pbs_resources_unicos8.7 +debian/tmp/usr/share/man/man7/pbs_resources_unicosmk2.7 +debian/tmp/usr/share/man/man7/pbs_resources.7 +debian/tmp/usr/share/man/man8/qdisable.8 +debian/tmp/usr/share/man/man8/qenable.8 +debian/tmp/usr/share/man/man8/qrun.8 +debian/tmp/usr/share/man/man8/qstart.8 +debian/tmp/usr/share/man/man8/qstop.8 +debian/tmp/usr/share/man/man8/qterm.8 --- torque-2.1.8+dfsg.orig/debian/torque-mom.install +++ torque-2.1.8+dfsg/debian/torque-mom.install @@ -0,0 +1 @@ +debian/tmp/usr/sbin/pbs_mom --- torque-2.1.8+dfsg.orig/debian/torque-scheduler.manpages +++ torque-2.1.8+dfsg/debian/torque-scheduler.manpages @@ -0,0 +1,4 @@ +debian/tmp/usr/share/man/man8/pbs_sched.8 +debian/tmp/usr/share/man/man8/pbs_sched_basl.8 +debian/tmp/usr/share/man/man8/pbs_sched_cc.8 +debian/tmp/usr/share/man/man8/pbs_sched_tcl.8 --- torque-2.1.8+dfsg.orig/debian/docs +++ torque-2.1.8+dfsg/debian/docs @@ -0,0 +1,4 @@ +PBS_License.txt +README.configure +README.mpiexec +README.torque --- torque-2.1.8+dfsg.orig/debian/changelog +++ torque-2.1.8+dfsg/debian/changelog @@ -0,0 +1,10 @@ +torque (2.1.8+dfsg-0ubuntu1) hardy; urgency=low + + * Initial release (LP: #173507) + * Patch to fix hyphen/minus problems problems in manpages. + * File doc/admin_guide.ps removed from upstream tarball due + to restrictive copyright. + * Lintian override on torque-client. /usr/sbin/pdb_iff really + must be suid to root in order to work. + + -- Morten Kjeldgaard Fri, 11 Jan 2008 02:48:51 +0100 --- torque-2.1.8+dfsg.orig/debian/control +++ torque-2.1.8+dfsg/debian/control @@ -0,0 +1,139 @@ +Source: torque +Section: utils +Priority: optional +Maintainer: Ubuntu MOTU Developers +XSBC-Original-Maintainer: Morten Kjeldgaard +Homepage: http://www.clusterresources.com/products/torque/ +Build-Depends: cdbs, debhelper (>= 5), autotools-dev, dpatch, chrpath, + tcl8.3-dev, tk8.3-dev, tclx8.3-dev, + libpam0g-dev, openssh-client +Standards-Version: 3.7.3 + +Package: torque-base +Section: utils +Architecture: all +Depends: openssh-client +Description: tera-scale Open-source Resource and QUEue manager + TORQUE (Tera-scale Open-source Resource and QUEue manager) is a resource + manager providing control over batch jobs and distributed compute + nodes. Torque is based on OpenPBS version 2.3.12 and incorporates + scalability, fault tolerance, and feature extension patches provided by + USC, NCSA, OSC, the U.S. Dept of Energy, Sandia, PNNL, U of Buffalo, + TeraGrid, and many other leading edge HPC organizations. + . + This package holds just a few shared files and directories. + +Package: torque-client +Section: utils +Architecture: any +Depends: torque-base, ${shlibs:Depends}, ${misc:Depends} +Description: client part of the Torque batch system + TORQUE (Tera-scale Open-source Resource and QUEue manager) is a resource + manager providing control over batch jobs and distributed compute + nodes. Torque is based on OpenPBS version 2.3.12 and incorporates + scalability, fault tolerance, and feature extension patches provided by + USC, NCSA, OSC, the U.S. Dept of Energy, Sandia, PNNL, U of Buffalo, + TeraGrid, and many other leading edge HPC organizations. + . + This package holds the command-line client programs. Install on + all hosts that should be able to submit jobs. + +Package: torque-dev +Section: libdevel +Architecture: any +Depends: libtorque0, torque-base +Description: development tools for programs which will use the torque library + TORQUE (Tera-scale Open-source Resource and QUEue manager) is a resource + manager providing control over batch jobs and distributed compute + nodes. Torque is based on OpenPBS version 2.3.12 and incorporates + scalability, fault tolerance, and feature extension patches provided by + USC, NCSA, OSC, the U.S. Dept of Energy, Sandia, PNNL, U of Buffalo, + TeraGrid, and many other leading edge HPC organizations. + . + This package includes the header files and static libraries necessary for + developing programs which will use torque. + +Package: libtorque0 +Section: libs +Architecture: any +Depends: ${shlibs:Depends}, torque-base +Description: Documentation for the Torque batch system + TORQUE (Tera-scale Open-source Resource and QUEue manager) is a resource + manager providing control over batch jobs and distributed compute + nodes. Torque is based on OpenPBS version 2.3.12 and incorporates + scalability, fault tolerance, and feature extension patches provided by + USC, NCSA, OSC, the U.S. Dept of Energy, Sandia, PNNL, U of Buffalo, + TeraGrid, and many other leading edge HPC organizations. + . + This package contains the shared library. + +Package: torque-gui +Section: utils +Architecture: any +Depends: ${shlibs:Depends}, torque-client +Description: graphical client for the Torque batch system + TORQUE (Tera-scale Open-source Resource and QUEue manager) is a resource + manager providing control over batch jobs and distributed compute + nodes. Torque is based on OpenPBS version 2.3.12 and incorporates + scalability, fault tolerance, and feature extension patches provided by + USC, NCSA, OSC, the U.S. Dept of Energy, Sandia, PNNL, U of Buffalo, + TeraGrid, and many other leading edge HPC organizations. + . + This package holds the graphical clients. + +Package: torque-mom +Section: utils +Architecture: any +Depends: ${shlibs:Depends}, ${misc:Depends}, torque-base +Description: execution part of Torque for compute nodes + TORQUE (Tera-scale Open-source Resource and QUEue manager) is a resource + manager providing control over batch jobs and distributed compute + nodes. Torque is based on OpenPBS version 2.3.12 and incorporates + scalability, fault tolerance, and feature extension patches provided by + USC, NCSA, OSC, the U.S. Dept of Energy, Sandia, PNNL, U of Buffalo, + TeraGrid, and many other leading edge HPC organizations. + . + This package holds the execute daemon required on every compute node. + +Package: torque-pam +Section: utils +Architecture: any +Depends: ${shlibs:Depends}, torque-base +Description: PAM module for PBS MOM nodes + TORQUE (Tera-scale Open-source Resource and QUEue manager) is a resource + manager providing control over batch jobs and distributed compute + nodes. Torque is based on OpenPBS version 2.3.12 and incorporates + scalability, fault tolerance, and feature extension patches provided by + USC, NCSA, OSC, the U.S. Dept of Energy, Sandia, PNNL, U of Buffalo, + TeraGrid, and many other leading edge HPC organizations. + . + A simple PAM module to authorize users on PBS MOM nodes with a running + job. + +Package: torque-scheduler +Section: utils +Architecture: any +Depends: ${shlibs:Depends}, ${misc:Depends}, torque-base +Description: scheduler part of Torque + TORQUE (Tera-scale Open-source Resource and QUEue manager) is a resource + manager providing control over batch jobs and distributed compute + nodes. Torque is based on OpenPBS version 2.3.12 and incorporates + scalability, fault tolerance, and feature extension patches provided by + USC, NCSA, OSC, the U.S. Dept of Energy, Sandia, PNNL, U of Buffalo, + TeraGrid, and many other leading edge HPC organizations. + . + This package holds the fifo C scheduler. + +Package: torque-server +Section: utils +Architecture: any +Depends: ${shlibs:Depends}, torque-base +Description: Torque server + TORQUE (Tera-scale Open-source Resource and QUEue manager) is a resource + manager providing control over batch jobs and distributed compute + nodes. Torque is based on OpenPBS version 2.3.12 and incorporates + scalability, fault tolerance, and feature extension patches provided by + USC, NCSA, OSC, the U.S. Dept of Energy, Sandia, PNNL, U of Buffalo, + TeraGrid, and many other leading edge HPC organizations. + . + This package holds the server. --- torque-2.1.8+dfsg.orig/debian/torque-mom.init +++ torque-2.1.8+dfsg/debian/torque-mom.init @@ -0,0 +1,85 @@ +#! /bin/sh +### BEGIN INIT INFO +# Provides: torque-init +# Required-Start: $all +# Required-Stop: $all +# Should-Start: $all +# Should-Stop: $all +# Default-Start: 2 3 4 5 +# Default-Stop: 0 1 6 +# Short-Description: Start and stop the PBS Mom +# Description: PBS is a versatile batch system for SMPs and clusters. +# This script controls the mom process. +### END INIT INFO + +PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin +DAEMON=/usr/sbin/pbs_mom +NAME=torque-mom +DESC="Torque Mom" + +test -x $DAEMON || exit 0 + +# Load lsb functions +. /lib/lsb/init-functions + +# Include defaults if available +if [ -f /etc/default/$NAME ] ; then + . /etc/default/$NAME +fi + +set -e + +case "$1" in + start) + log_begin_msg "Starting $DESC: " + start-stop-daemon --start --quiet --pidfile /var/run/$NAME.pid \ + --exec $DAEMON -- $DAEMON_OPTS + log_end_msg $? + ;; + stop) + log_begin_msg "Stopping $DESC: " + start-stop-daemon --stop --quiet --pidfile /var/run/$NAME.pid \ + --exec $DAEMON + log_end_msg $? + ;; + reload) + # Reload config file by sending a SIGHUP + log_begin_msg "Reloading $DESC configuration files." + start-stop-daemon --stop --signal 1 --quiet --pidfile \ + /var/run/$NAME.pid --exec $DAEMON + log_end_msg $? + ;; + force-reload) + # check wether $DAEMON is running. If so, restart + start-stop-daemon --stop --test --quiet --pidfile \ + /var/run/$NAME.pid --exec $DAEMON \ + && $0 restart \ + || exit 0 + ;; + restart) + log_begin_msg "Restarting $DESC: " + start-stop-daemon --stop --quiet --pidfile \ + /var/run/$NAME.pid --exec $DAEMON + sleep 1 + start-stop-daemon --start --quiet --pidfile \ + /var/run/$NAME.pid --exec $DAEMON -- $DAEMON_OPTS + log_end_msg $? + ;; + purge) + log_begin_msg "Starting TORQUE Mom with purge: " + start-stop-daemon --start --quiet --pidfile \ + /var/run/$NAME.pid --exec $DAEMON -- $DAEMON_OPTS -r + log_end_msg $? + ;; + *) + N=/etc/init.d/$NAME + log_success_msg "Usage: $N {start|stop|restart|force-reload}" + exit 1 + ;; +esac + +exit 0 + +# Local variables: +# mode: font-lock +# End: --- torque-2.1.8+dfsg.orig/debian/copyright +++ torque-2.1.8+dfsg/debian/copyright @@ -0,0 +1,129 @@ +This package was debianized by Morten Kjeldgaard on +Thu, 23 Aug 2007 23:44:10 +0200. + +It was downloaded from + http://www.clusterresources.com/pages/products/torque-resource-manager.php + +Upstream Author: + TORQUE (Terascale Open-source Resource and QUEue manger) is an open source + project based on the original PBS* resource manager developed by NASA, + LLNL, and MRJ. It possesses a large number of enhancements contributed by + organizations such as OSC, NCSA, TeraGrid, the U.S Dept of Energy, USC, and + many, many others. It continues to incorporate significant advancements in + the areas of scalability, fault-tolerance, usability, functionality, and + security development from the community and vendor supporters. It may be + utilized, modified, and distributed subject to the constraints of the + license located in the PBS_License.txt file. If you would like to + contribute to this project or have patches, enhancements, or associated + projects you would like to have included in this project, please send email + to help@supercluster.org + +Homepage: http://clusterresources.com/torque + +Copyright: Copyright (c) 1999-2000 Veridian Information Solutions, Inc. + All rights reserved. + +License: + The torque sources are distributed accoding to the OpenPBS Software + license v2.3 listed below. + + * PLEASE NOTICE THAT PARAGRAPHS 1 AND 2 HAVE EXPIRED AS OF DECEMBER 31, 2001. + + + OpenPBS (Portable Batch System) v2.3 Software License + + Copyright (c) 1999-2000 Veridian Information Solutions, Inc. + All rights reserved. + + --------------------------------------------------------------------------- + For a license to use or redistribute the OpenPBS software under conditions + other than those described below, or to purchase support for this software, + please contact Veridian Systems, PBS Products Department ("Licensor") at: + + www.OpenPBS.org +1 650 967-4675 sales@OpenPBS.org + 877 902-4PBS (US toll-free) + --------------------------------------------------------------------------- + + This license covers use of the OpenPBS v2.3 software (the "Software") at + your site or location, and, for certain users, redistribution of the + Software to other sites and locations. Use and redistribution of + OpenPBS v2.3 in source and binary forms, with or without modification, + are permitted provided that all of the following conditions are met. + After December 31, 2001, only conditions 3-6 must be met: + + 1. Commercial and/or non-commercial use of the Software is permitted + provided a current software registration is on file at www.OpenPBS.org. + If use of this software contributes to a publication, product, or + service, proper attribution must be given; see www.OpenPBS.org/credit.html + + 2. Redistribution in any form is only permitted for non-commercial, + non-profit purposes. There can be no charge for the Software or any + software incorporating the Software. Further, there can be no + expectation of revenue generated as a consequence of redistributing + the Software. + + 3. Any Redistribution of source code must retain the above copyright notice + and the acknowledgment contained in paragraph 6, this list of conditions + and the disclaimer contained in paragraph 7. + + 4. Any Redistribution in binary form must reproduce the above copyright + notice and the acknowledgment contained in paragraph 6, this list of + conditions and the disclaimer contained in paragraph 7 in the + documentation and/or other materials provided with the distribution. + + 5. Redistributions in any form must be accompanied by information on how to + obtain complete source code for the OpenPBS software and any + modifications and/or additions to the OpenPBS software. The source code + must either be included in the distribution or be available for no more + than the cost of distribution plus a nominal fee, and all modifications + and additions to the Software must be freely redistributable by any party + (including Licensor) without restriction. + + 6. All advertising materials mentioning features or use of the Software must + display the following acknowledgment: + + "This product includes software developed by NASA Ames Research Center, + Lawrence Livermore National Laboratory, and Veridian Information Solutions, + Inc. Visit www.OpenPBS.org for OpenPBS software support, + products, and information." + + 7. DISCLAIMER OF WARRANTY + + THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. ANY EXPRESS + OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES + OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT + ARE EXPRESSLY DISCLAIMED. + + IN NO EVENT SHALL VERIDIAN CORPORATION, ITS AFFILIATED COMPANIES, OR THE + U.S. GOVERNMENT OR ANY OF ITS AGENCIES BE LIABLE FOR ANY DIRECT OR INDIRECT, + INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT + LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, + OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF + LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING + NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, + EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + This license will be governed by the laws of the Commonwealth of Virginia, + without reference to its choice of law rules. + + Addendum + To obtain complete source code for OpenPBS and modifications/additions + provided in torque visit www.openpbs.org and/or + www.supercluster.org/downloads. + + +The Debian packaging is (C) 2007, Morten Kjeldgaard and +is licensed under the BSD license, `/usr/share/common-licenses/BSD'. + + +Repackaging of upstream tarball +------------------------------- + +Due to a restrictive copyright in the file doc/admin_guide.ps, +it was removed from the source package, and the tarball was repackaged. +This operation can be carried out using the following command in the main +directory: + + debian/rules get-orig-source + +which will generate a repackaged tarball named torque_2.1.8+dfsg.orig.tar.gz --- torque-2.1.8+dfsg.orig/debian/torque-scheduler.dirs +++ torque-2.1.8+dfsg/debian/torque-scheduler.dirs @@ -0,0 +1,2 @@ +/var/lib/torque/sched_priv +/var/lib/torque/sched_logs --- torque-2.1.8+dfsg.orig/debian/torque-server.init +++ torque-2.1.8+dfsg/debian/torque-server.init @@ -0,0 +1,79 @@ +#! /bin/sh +### BEGIN INIT INFO +# Provides: torque-server +# Required-Start: $all +# Required-Stop: $all +# Should-Start: $all +# Should-Stop: $all +# Default-Start: 2 3 4 5 +# Default-Stop: 0 1 6 +# Short-Description: Start and stop the PBS server +# Description: PBS is a versatile batch system for SMPs and clusters. +# This script controls the server process. +### END INIT INFO + +PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin +DAEMON=/usr/sbin/pbs_server +NAME=torque-server +DESC="Torque batch queue server" + +test -x $DAEMON || exit 0 + +# Load lsb functions +. /lib/lsb/init-functions + +# Include defaults if available +if [ -f /etc/default/$NAME ] ; then + . /etc/default/$NAME +fi + +set -e + +case "$1" in + start) + log_begin_msg "Starting $DESC: " + start-stop-daemon --start --quiet --pidfile /var/run/$NAME.pid \ + --exec $DAEMON -- $DAEMON_OPTS + log_end_msg $? + ;; + stop) + log_begin_msg "Stopping $DESC: " + start-stop-daemon --stop --quiet --pidfile /var/run/$NAME.pid \ + --exec $DAEMON + log_end_msg $? + ;; + reload) + # Send the server SIGHUP, to reload the configuration + log_begin_msg "Reloading $DESC configuration files." + start-stop-daemon --stop --signal 1 --quiet --pidfile \ + /var/run/$NAME.pid --exec $DAEMON + log_end_msg $? + ;; + force-reload) + # check wether $DAEMON is running. If so, restart + start-stop-daemon --stop --test --quiet --pidfile \ + /var/run/$NAME.pid --exec $DAEMON \ + && $0 restart \ + || exit 0 + ;; + restart) + log_begin_msg "Restarting $DESC: " + start-stop-daemon --stop --quiet --pidfile \ + /var/run/$NAME.pid --exec $DAEMON + sleep 1 + start-stop-daemon --start --quiet --pidfile \ + /var/run/$NAME.pid --exec $DAEMON -- $DAEMON_OPTS + log_end_msg $? + ;; + *) + N=/etc/init.d/$NAME + log_success_msg "Usage: $N {start|stop|restart|reload|force-reload}" + exit 1 + ;; +esac + +exit 0 + +# Local variables: +# mode: font-lock +# End: