From f86f82f43db3aa1e095fc9b9026e1f095e1e44fb Mon Sep 17 00:00:00 2001
From: Moe Jette <jette1@llnl.gov>
Date: Tue, 21 Sep 2010 22:34:52 +0000
Subject: [PATCH] torque/qsub: add warning / help message regarding missing
options
---
contribs/torque/qsub.pl | 53 ++++++++++++++++++++++++++++++++---------
1 file changed, 42 insertions(+), 11 deletions(-)
diff --git a/contribs/torque/qsub.pl b/contribs/torque/qsub.pl
index dc5bff4948b..6aa8ad92bcc 100755
--- a/contribs/torque/qsub.pl
+++ b/contribs/torque/qsub.pl
@@ -86,7 +86,8 @@ GetOptions('a=s' => \$start_time,
'e=s' => \$err_path,
'h' => \$hold,
'I' => \$interactive,
-# 'j:s' => \$join,
+ 'j:s' => sub { warn "option -j is the default, " .
+ "stdout/stderr go into the same file\n" },
# 'k=s' => \$keep,
'l=s' => \$resource_list,
'm=s' => \$mail_options,
@@ -98,8 +99,12 @@ GetOptions('a=s' => \$start_time,
# 'r=s' => \$rerunable,
# 'S=s' => \$script_path,
# 'u=s' => \$running_user_list,
-# 'v=s' => \$variable_list,
-# 'V' => \$all_env,
+ 'v=s' => sub { warn "option -v is not supported, " .
+ "since the current environment " .
+ "is exported by default\n" },
+ 'V' => sub { warn "option -V is not necessary, " .
+ "since the current environment " .
+ "is exported by default\n" },
'W' => \$additional_attributes,
# 'z' => \$no_std,
'help|?' => \$help,
@@ -349,16 +354,25 @@ B<qsub> - submit a batch job in a familiar pbs format
=head1 SYNOPSIS
-qsub [-a date_time] [-A account_string] [-b secs] [-c interval]
- [-C directive_prefix] [-e path] [-h] [-I]
- [-j join] [-k keep] [-l resource_list] [-m mail_options]
- [-M user_list] [-N name] [-o path] [-p priority] [-q destination]
- [-r c] [-S path_list] [-u user_list] [-v variable_list] [-V]
- [-W additional_attributes] [-z] [script]
+qsub [-a date_time]
+ [-A account_string]
+ [-b secs]
+ [-C directive_prefix]
+ [-e path]
+ [-I]
+ [-l resource_list]
+ [-m mail_options] [-M user_list]
+ [-N name]
+ [-o path]
+ [-p priority]
+ [-q destination]
+ [-W additional_attributes]
+ [-h]
+ [script]
=head1 DESCRIPTION
-The B<qsub> command displays information about nodes.
+The B<qsub> command displays information about nodes. It is aimed to be feature-compatible with PBS' qsub.
=head1 OPTIONS
@@ -368,7 +382,24 @@ The B<qsub> command displays information about nodes.
Display information for all nodes. This is the default if no node name is specified.
-=item B<-? | --help>
+=item B<-I>
+
+Interactive execution.
+
+=item B<-j> join
+
+It is not necessary (currently also not possible) since stderr/stdout are always joined.
+
+=item B<-v> [variable_list]
+
+Exporting single variables via -v is not supported, since the entire login environment
+is exported by the default.
+
+=item B<-V>
+
+The -V option to export the current environment is not required since it is done by default.
+
+=item B<-?> | B<--help>
brief help message
--
GitLab