From fc1dafd58e29280ef0051fa3efae53efef1e5db3 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Zden=C4=9Bk=20=C5=A0ustr?= Date: Mon, 8 Aug 2011 11:38:33 +0000 Subject: [PATCH] Extended explnation of glite-lb-notify cmdline options. Stop me if I'm wrong :-) --- org.glite.lb.client/doc/glite-lb-notify.1 | 33 ++++++++++++++++++++++++++++++- org.glite.lb.client/src/notify.c | 2 +- 2 files changed, 33 insertions(+), 2 deletions(-) diff --git a/org.glite.lb.client/doc/glite-lb-notify.1 b/org.glite.lb.client/doc/glite-lb-notify.1 index b6015f8..deeb602 100644 --- a/org.glite.lb.client/doc/glite-lb-notify.1 +++ b/org.glite.lb.client/doc/glite-lb-notify.1 @@ -6,7 +6,7 @@ glite-lb-notify - Register and receive notification from L&B .SH SYNOPSIS .B glite-lb-notify .br - \fBnew\fR [ { \fB-s\fI socket_fd\fR | \fB-a \fIfake_addr\fR } \fB-t \fIrequested_validity\fR \fB-j \fIjobid \fR| { \fB-o \fIowner \fR | \fB -O \fR } \fB-n \fInetwork_server \fR \fB-v\fI virtual_organization\fR \fB-c \fR \fB-f\fI flags\fR ] + \fBnew\fR [ { \fB-s\fI socket_fd\fR | \fB-a \fIfake_addr\fR } \fB-t \fIrequested_validity\fR \fB-j \fIjobid \fR| { \fB-o \fIowner \fR | \fB -O \fR } \fB-n \fInetwork_server \fR \fB-v\fI virtual_organization\fR \fB-c\fR \fB-J\fR \fB-B\fR \fB-T\fR \fB-E\fR \fB-f\fI flags\fR ] .br \fBbind \fR [ { \fB-s\fI socket_fd\fR | \fB-a \fIfake_addr\fR } \fB-t \fIrequested_validity\fR ] \fInotifid\fR .br @@ -126,6 +126,37 @@ to get list of available fields. Drop the notification from the server, removing all messages on the way eventually. +.SH \ + +Options for the \fBnew\fR subcommand: +.TP +.B -o +match on events for jobs belonging to the given \fIDN\fR. +.TP +.B -O +match on events for jobs belonging to the current user. +.TP +.B -v +match on events for jobs belonging to users from the given \fIVO\fR. +.TP +.B -c +match only if job state has actually changed. Notification messages won't be sent for events that do not trigger job state change. +.TP +.B -S +match only on jobs in certain \fIstates\fR listed in a comma-separated list. +.TP +.B -J +pack JDL with the job status structure. +.TP +.B -B +bootstrap -- send past events matching conditions. +.TP +.B -T +match only on reaching a terminal state. +.TP +.B -E +match only on reaching a terminal state and pack a summary of all events for that job. + .SH EXAMPLE Installed with the package as share/examples/glite-lb-notify.pl. Demontstrates using the non-trivial diff --git a/org.glite.lb.client/src/notify.c b/org.glite.lb.client/src/notify.c index 5ce7d6e..05dcd40 100644 --- a/org.glite.lb.client/src/notify.c +++ b/org.glite.lb.client/src/notify.c @@ -50,7 +50,7 @@ static void usage(char *cmd) me); } if ( !cmd || !strcmp(cmd, "new") ) - fprintf(stderr,"\n'new' command usage: %s new [ { -s socket_fd | -a fake_addr } -t requested_validity -j jobid { -o owner | -O } -n network_server -v virtual_organization --states state1,state2,... -c -B -T -E -f flags]\n" + fprintf(stderr,"\n'new' command usage: %s new [ { -s socket_fd | -a fake_addr } -t requested_validity -j jobid { -o owner | -O } -n network_server -v virtual_organization --states state1,state2,... -c -S -J -B -T -E -f flags]\n" " jobid Job ID to connect notif. reg. with\n" " owner Match this owner DN\n" " requested_validity Validity of notification req. in seconds\n" -- 1.8.2.3