cctools
work_queue.h
Go to the documentation of this file.
1 /*
2 Copyright (C) 2008- The University of Notre Dame
3 This software is distributed under the GNU General Public License.
4 See the file COPYING for details.
5 */
6 
7 #ifndef WORK_QUEUE_H
8 #define WORK_QUEUE_H
9 
20 #include <sys/types.h>
21 #include "timestamp.h"
22 #include "category.h"
23 #include "rmsummary.h"
24 
25 #define WORK_QUEUE_DEFAULT_PORT 9123
26 #define WORK_QUEUE_RANDOM_PORT 0
28 #define WORK_QUEUE_WAITFORTASK -1
30 #define WORK_QUEUE_DEFAULT_KEEPALIVE_INTERVAL 120
31 #define WORK_QUEUE_DEFAULT_KEEPALIVE_TIMEOUT 30
33 typedef enum {
37 
38 typedef enum {
50 
51 typedef enum {
52  WORK_QUEUE_SCHEDULE_UNSET = 0,
59 
60 
61 typedef enum {
77 
78 typedef enum {
87 
88 typedef enum {
96 
97 
100 typedef enum {
116  WORK_QUEUE_ALLOCATION_MODE_MAX_THROUGHPUT = CATEGORY_ALLOCATION_MODE_MAX_THROUGHPUT
118 
119 
120 extern int wq_option_scheduler;
131  char *tag;
132  char *command_line;
134  char *output;
135  struct list *input_files;
136  struct list *output_files;
137  struct list *env_list;
138  int taskid;
141  char *host;
142  char *hostname;
144  char *category;
147  double priority;
150  int try_count;
154  /* All times in microseconds */
155  /* A time_when_* refers to an instant in time, otherwise it refers to a length of time. */
174  int64_t bytes_received;
175  int64_t bytes_sent;
184  struct list *features;
186  /* deprecated fields */
187  //int total_submissions; /**< @deprecated Use try_count. */
188 
215 };
216 
220  /* Stats for the current state of workers: */
227  /* Cumulative stats for workers: */
236  /* Stats for the current state of tasks: */
242  /* Cumulative stats for tasks: */
250  /* All times in microseconds */
251  /* A time_when_* refers to an instant in time, otherwise it refers to a length of time. */
252 
253  /* Master time statistics: */
264  /* Workers time statistics: */
269  /* BW statistics */
270  int64_t bytes_sent;
271  int64_t bytes_received;
272  double bandwidth;
274  /* resources statistics */
283  int64_t total_cores;
284  int64_t total_memory;
285  int64_t total_disk;
287  int64_t committed_cores;
289  int64_t committed_disk;
291  int64_t max_cores;
292  int64_t max_memory;
293  int64_t max_disk;
295  int64_t min_cores;
296  int64_t min_memory;
297  int64_t min_disk;
299  double manager_load;
333  double capacity;
335  double efficiency;
338  int64_t total_gpus;
339  int64_t committed_gpus;
340  int64_t max_gpus;
341  int64_t min_gpus;
343  int port;
344  int priority;
350 };
351 
352 
353 /* Forward declare the queue's structure. This structure is opaque and defined in work_queue.c */
354 struct work_queue;
355 
356 
360 
368 struct work_queue_task *work_queue_task_create(const char *full_command);
369 
375 struct work_queue_task *work_queue_task_clone(const struct work_queue_task *task);
376 
381 void work_queue_task_specify_command( struct work_queue_task *t, const char *cmd );
382 
399 int work_queue_task_specify_file(struct work_queue_task *t, const char *local_name, const char *remote_name, work_queue_file_type_t type, work_queue_file_flags_t flags);
400 
415 int work_queue_task_specify_file_piece(struct work_queue_task *t, const char *local_name, const char *remote_name, off_t start_byte, off_t end_byte, work_queue_file_type_t type, work_queue_file_flags_t flags);
416 
427 int work_queue_task_specify_buffer(struct work_queue_task *t, const char *data, int length, const char *remote_name, work_queue_file_flags_t flags);
428 
442 int work_queue_task_specify_directory(struct work_queue_task *t, const char *local_name, const char *remote_name, work_queue_file_type_t type, work_queue_file_flags_t flags, int recursive);
443 
456 int work_queue_task_specify_file_command(struct work_queue_task *t, const char *remote_name, const char *cmd, work_queue_file_type_t type, work_queue_file_flags_t flags);
457 
464 
470 void work_queue_task_specify_memory( struct work_queue_task *t, int64_t memory );
471 
477 void work_queue_task_specify_disk( struct work_queue_task *t, int64_t disk );
478 
484 void work_queue_task_specify_cores( struct work_queue_task *t, int cores );
485 
491 void work_queue_task_specify_gpus( struct work_queue_task *t, int gpus );
492 
500 void work_queue_task_specify_end_time( struct work_queue_task *t, int64_t useconds );
501 
508 void work_queue_task_specify_start_time_min( struct work_queue_task *t, int64_t useconds );
509 
517 void work_queue_task_specify_running_time( struct work_queue_task *t, int64_t useconds );
518 
526 void work_queue_task_specify_running_time_max( struct work_queue_task *t, int64_t seconds );
527 
534 void work_queue_task_specify_running_time_min( struct work_queue_task *t, int64_t seconds );
535 
542 void work_queue_task_specify_tag(struct work_queue_task *t, const char *tag);
543 
549 void work_queue_task_specify_category(struct work_queue_task *t, const char *category);
550 
555 void work_queue_task_specify_feature(struct work_queue_task *t, const char *name);
556 
564 
571 void work_queue_task_specify_environment_variable( struct work_queue_task *t, const char *name, const char *value );
572 
579 
585 void work_queue_task_specify_monitor_output(struct work_queue_task *t, const char *monitor_output);
586 
592 
593 
645 
646 
648 
652 
669 struct work_queue *work_queue_create(int port);
670 
671 
680 struct work_queue *work_queue_ssl_create(int port, const char *key, const char *cert);
681 
695 int work_queue_enable_monitoring(struct work_queue *q, char *monitor_output_directory, int watchdog);
696 
706 int work_queue_enable_monitoring_full(struct work_queue *q, char *monitor_output_directory, int watchdog);
707 
716 int work_queue_submit(struct work_queue *q, struct work_queue_task *t);
717 
718 
729 int work_queue_specify_min_taskid(struct work_queue *q, int minid);
730 
735 void work_queue_block_host(struct work_queue *q, const char *hostname);
736 
744 void work_queue_block_host_with_timeout(struct work_queue *q, const char *hostname, time_t seconds);
745 
746 
751 void work_queue_unblock_host(struct work_queue *q, const char *hostname);
752 
756 void work_queue_unblock_all(struct work_queue *q);
757 
771 void work_queue_invalidate_cached_file(struct work_queue *q, const char *local_name, work_queue_file_t type);
772 
773 
788 struct work_queue_task *work_queue_wait(struct work_queue *q, int timeout);
789 
790 
798 struct work_queue_task *work_queue_wait_for_tag(struct work_queue *q, const char *tag, int timeout);
799 
811 int work_queue_hungry(struct work_queue *q);
812 
820 int work_queue_empty(struct work_queue *q);
821 
828 int work_queue_port(struct work_queue *q);
829 
834 void work_queue_get_stats(struct work_queue *q, struct work_queue_stats *s);
835 
840 void work_queue_get_stats_hierarchy(struct work_queue *q, struct work_queue_stats *s);
841 
847 void work_queue_get_stats_category(struct work_queue *q, const char *c, struct work_queue_stats *s);
848 
849 
854 struct rmsummary **work_queue_workers_summary(struct work_queue *q);
855 
861 work_queue_task_state_t work_queue_task_state(struct work_queue *q, int taskid);
862 
867 void work_queue_set_bandwidth_limit(struct work_queue *q, const char *bandwidth);
868 
873 double work_queue_get_effective_bandwidth(struct work_queue *q);
874 
881 char * work_queue_get_worker_summary( struct work_queue *q );
882 
892 int work_queue_activate_fast_abort(struct work_queue *q, double multiplier);
893 
894 
904 int work_queue_activate_fast_abort_category(struct work_queue *q, const char *category, double multiplier);
905 
906 
915 int work_queue_specify_draining_by_hostname(struct work_queue *q, const char *hostname, int drain_flag);
916 
923 int work_queue_specify_category_mode(struct work_queue *q, const char *category, work_queue_category_mode_t mode);
924 
932 int work_queue_enable_category_resource(struct work_queue *q, const char *category, const char *resource, int autolabel);
933 
939 void work_queue_specify_algorithm(struct work_queue *q, work_queue_schedule_t algorithm);
940 
945 const char *work_queue_name(struct work_queue *q);
946 
951 void work_queue_specify_name(struct work_queue *q, const char *name);
952 
957 void work_queue_specify_debug_path(struct work_queue *q, const char *path);
958 
963 void work_queue_specify_tlq_port(struct work_queue *q, int port);
964 
969 void work_queue_specify_priority(struct work_queue *q, int priority);
970 
979 void work_queue_specify_num_tasks_left(struct work_queue *q, int ntasks);
980 
986 void work_queue_specify_catalog_server(struct work_queue *q, const char *hostname, int port);
987 
992 void work_queue_specify_catalog_servers(struct work_queue *q, const char *hosts);
993 
999 struct work_queue_task *work_queue_cancel_by_taskid(struct work_queue *q, int id);
1000 
1006 struct work_queue_task *work_queue_cancel_by_tasktag(struct work_queue *q, const char *tag);
1007 
1012 struct list * work_queue_cancel_all_tasks(struct work_queue *q);
1013 
1018 int work_queue_shut_down_workers(struct work_queue *q, int n);
1019 
1024 void work_queue_delete(struct work_queue *q);
1025 
1031 int work_queue_specify_log(struct work_queue *q, const char *logfile);
1032 
1038 int work_queue_specify_transactions_log(struct work_queue *q, const char *logfile);
1039 
1045 void work_queue_specify_password( struct work_queue *q, const char *password );
1046 
1053 int work_queue_specify_password_file( struct work_queue *q, const char *file );
1054 
1059 void work_queue_specify_keepalive_interval(struct work_queue *q, int interval);
1060 
1065 void work_queue_specify_keepalive_timeout(struct work_queue *q, int timeout);
1066 
1072 void work_queue_manager_preferred_connection(struct work_queue *q, const char *preferred_connection);
1073 
1094 int work_queue_tune(struct work_queue *q, const char *name, double value);
1095 
1101 void work_queue_specify_max_resources(struct work_queue *q, const struct rmsummary *rm);
1102 
1108 void work_queue_specify_min_resources(struct work_queue *q, const struct rmsummary *rm);
1109 
1115 void work_queue_specify_category_max_resources(struct work_queue *q, const char *category, const struct rmsummary *rm);
1116 
1122 void work_queue_specify_category_min_resources(struct work_queue *q, const char *category, const struct rmsummary *rm);
1123 
1129 void work_queue_specify_category_first_allocation_guess(struct work_queue *q, const char *category, const struct rmsummary *rm);
1130 
1136 void work_queue_initialize_categories(struct work_queue *q, struct rmsummary *max, const char *summaries_file);
1137 
1138 
1143 const char *work_queue_result_str(work_queue_result_t result);
1144 
1146 
1150 
1151 #define WORK_QUEUE_TASK_ORDER_FIFO 0
1152 #define WORK_QUEUE_TASK_ORDER_LIFO 1
1160 void work_queue_specify_task_order(struct work_queue *q, int order);
1161 
1162 
1163 #define WORK_QUEUE_MANAGER_MODE_STANDALONE 0
1164 #define WORK_QUEUE_MANAGER_MODE_CATALOG 1
1173 void work_queue_specify_manager_mode(struct work_queue *q, int mode);
1174 
1175 
1181 void work_queue_specify_estimate_capacity_on(struct work_queue *q, int estimate_capacity_on);
1182 
1191 int work_queue_task_specify_input_buf(struct work_queue_task *t, const char *buf, int length, const char *rname);
1192 
1200 int work_queue_task_specify_input_file(struct work_queue_task *t, const char *fname, const char *rname);
1201 
1209 int work_queue_task_specify_input_file_do_not_cache(struct work_queue_task *t, const char *fname, const char *rname);
1210 
1218 int work_queue_task_specify_output_file(struct work_queue_task *t, const char *rname, const char *fname);
1219 
1227 int work_queue_task_specify_output_file_do_not_cache(struct work_queue_task *t, const char *rname, const char *fname);
1228 
1234 char *work_queue_generate_disk_alloc_full_filename(char *pwd, int taskid);
1235 
1236 
1239 void work_queue_task_specify_enviroment_variable( struct work_queue_task *t, const char *name, const char *value );
1240 
1242 
1243 // Renames for backwards compatibility
1244 #define work_queue_master_preferred_connection work_queue_manager_preferred_connection
1245 #define work_queue_specify_master_mode work_queue_specify_manager_mode
1246 #define work_queue_blacklist_add work_queue_block_host
1247 #define work_queue_blacklist_add_with_timeout work_queue_block_host_with_timeout
1248 #define work_queue_blacklist_remove work_queue_unblock_host
1249 #define work_queue_blacklist_clear work_queue_unblock_all
1250 
1251 #endif
int64_t total_memory
Total memory in MB aggregated across the connected workers.
Definition: work_queue.h:284
int work_queue_specify_min_taskid(struct work_queue *q, int minid)
Set the minimum taskid of future submitted tasks.
As above, but maximizing throughput.
Definition: work_queue.h:114
Only return this output file if the task succeeded.
Definition: work_queue.h:46
int try_count
The number of times the task has been dispatched to a worker.
Definition: work_queue.h:150
Task is ready to be run, waiting in queue.
Definition: work_queue.h:80
int64_t committed_gpus
Definition: work_queue.h:339
void work_queue_manager_preferred_connection(struct work_queue *q, const char *preferred_connection)
Set the preference for using hostname over IP address to connect.
int64_t bytes_sent
Number of bytes sent since task has last started sending input data.
Definition: work_queue.h:175
If the filename already exists on the host, use it in place.
Definition: work_queue.h:48
int work_queue_task_specify_file_command(struct work_queue_task *t, const char *remote_name, const char *cmd, work_queue_file_type_t type, work_queue_file_flags_t flags)
Gets/puts file at remote_name using cmd at worker.
void work_queue_specify_estimate_capacity_on(struct work_queue *q, int estimate_capacity_on)
Change whether to estimate manager capacity for a given queue.
timestamp_t time_workers_execute
Total time workers spent executing done tasks.
Definition: work_queue.h:265
int64_t bytes_received
Number of bytes received since task has last started receiving input data.
Definition: work_queue.h:174
category_allocation_t resource_request
See category_allocation_t.
Definition: work_queue.h:145
int64_t committed_disk
Committed disk space in MB aggregated across the connected workers.
Definition: work_queue.h:289
Task results are available at the worker.
Definition: work_queue.h:82
int workers_connected
Number of workers currently connected to the manager.
Definition: work_queue.h:221
int capacity_cores
The estimated number of workers&#39; cores that this manager can effectively support. ...
Definition: work_queue.h:276
int total_exhausted_attempts
Definition: work_queue.h:320
int64_t min_disk
The smallest disk space in MB observed among the connected workers.
Definition: work_queue.h:297
int disk_allocation_exhausted
Non-zero if a task filled its loop device allocation, zero otherwise.
Definition: work_queue.h:159
int work_queue_task_specify_file_piece(struct work_queue_task *t, const char *local_name, const char *remote_name, off_t start_byte, off_t end_byte, work_queue_file_type_t type, work_queue_file_flags_t flags)
Add a file piece to a task.
A task description.
Definition: work_queue.h:130
void work_queue_task_specify_cores(struct work_queue_task *t, int cores)
Specify the number of cores required by a task.
int workers_lost
Total number of worker connections that were unexpectedly lost.
Definition: work_queue.h:234
int work_queue_task_specify_directory(struct work_queue_task *t, const char *local_name, const char *remote_name, work_queue_file_type_t type, work_queue_file_flags_t flags, int recursive)
Add a directory to a task.
void work_queue_task_specify_feature(struct work_queue_task *t, const char *name)
Label the task with a user-defined feature.
timestamp_t total_good_execute_time
Definition: work_queue.h:327
timestamp_t time_send_good
Total time spent in sending data to workers for tasks with result WQ_RESULT_SUCCESS.
Definition: work_queue.h:257
timestamp_t time_send_input_start
Definition: work_queue.h:193
int tasks_on_workers
Number of tasks currently dispatched to some worker.
Definition: work_queue.h:238
int tasks_dispatched
Total number of tasks dispatch to workers.
Definition: work_queue.h:244
void work_queue_task_specify_enviroment_variable(struct work_queue_task *t, const char *name, const char *value)
Same as work_queue_task_specify_environment_variable, but with a typo in environment.
struct list * work_queue_cancel_all_tasks(struct work_queue *q)
Cancel all submitted tasks and remove them from the queue.
timestamp_t start_time
Definition: work_queue.h:321
timestamp_t cmd_execution_time
Definition: work_queue.h:205
int work_queue_specify_draining_by_hostname(struct work_queue *q, const char *hostname, int drain_flag)
Set the draining mode per worker hostname.
char * monitor_output_directory
Custom output directory for the monitoring output files.
Definition: work_queue.h:181
struct list * features
User-defined features this task requires.
Definition: work_queue.h:184
int64_t bytes_received
Total number of file bytes (not including protocol control msg bytes) received from the workers by th...
Definition: work_queue.h:271
int tasks_running
Number of tasks currently executing at some worker.
Definition: work_queue.h:239
int work_queue_task_specify_input_file_do_not_cache(struct work_queue_task *t, const char *fname, const char *rname)
Add an input file to a task, without caching.
int total_workers_joined
Definition: work_queue.h:308
timestamp_t time_receive_good
Total time spent in sending data to workers for tasks with result WQ_RESULT_SUCCESS.
Definition: work_queue.h:258
Task results are available at the manager.
Definition: work_queue.h:83
timestamp_t total_exhausted_execute_time
Definition: work_queue.h:328
Implements bookkeeping for categories of tasks and their resources.
int workers_joined
Total number of worker connections that were established to the manager.
Definition: work_queue.h:228
int work_queue_task_specify_output_file(struct work_queue_task *t, const char *rname, const char *fname)
Add an output file to a task.
As above, but tasks are first tried with an automatically computed allocation to minimize resource wa...
Definition: category.h:44
When monitoring is disabled, all tasks run as WORK_QUEUE_ALLOCATION_MODE_FIXED.
Definition: work_queue.h:104
timestamp_t time_when_submitted
The time at which this task was added to the queue.
Definition: work_queue.h:156
timestamp_t time_workers_execute_last
Duration of the last complete execution for this task.
Definition: work_queue.h:169
timestamp_t time_receive_output_start
Definition: work_queue.h:197
int workers_blacklisted
Definition: work_queue.h:349
timestamp_t total_cmd_execution_time
Definition: work_queue.h:206
void work_queue_get_stats(struct work_queue *q, struct work_queue_stats *s)
Get queue statistics (only from manager).
int workers_removed
Total number of worker connections that were released by the manager, idled-out, fast-aborted, or lost.
Definition: work_queue.h:229
struct work_queue_task * work_queue_cancel_by_taskid(struct work_queue *q, int id)
Cancel a submitted task using its task id and remove it from queue.
int workers_full
Definition: work_queue.h:346
timestamp_t time_workers_execute_all
Accumulated time for executing the command on any worker, regardless of whether the task completed (i...
Definition: work_queue.h:170
void work_queue_specify_debug_path(struct work_queue *q, const char *path)
Change the debug log path for a given queue (used by TLQ).
int total_tasks_dispatched
Definition: work_queue.h:316
int capacity_memory
The estimated number of workers&#39; MB of RAM that this manager can effectively support.
Definition: work_queue.h:277
struct work_queue * work_queue_create(int port)
Create a new work queue.
The task failed because an output could be transfered to the manager (not enough disk space...
Definition: work_queue.h:75
timestamp_t total_good_transfer_time
Definition: work_queue.h:324
int workers_init
Number of workers connected, but that have not send their available resources report yet...
Definition: work_queue.h:222
int work_queue_enable_category_resource(struct work_queue *q, const char *category, const char *resource, int autolabel)
Turn on or off first-allocation labeling for a given category and resource.
int work_queue_task_specify_output_file_do_not_cache(struct work_queue_task *t, const char *rname, const char *fname)
Add an output file to a task without caching.
void work_queue_specify_tlq_port(struct work_queue *q, int port)
Change the home host and port for a given queue (used by TLQ).
timestamp_t time_send_input_finish
Definition: work_queue.h:194
void work_queue_block_host_with_timeout(struct work_queue *q, const char *hostname, time_t seconds)
Block workers in hostname from a queue, but remove block after timeout seconds.
void work_queue_get_stats_hierarchy(struct work_queue *q, struct work_queue_stats *s)
Get statistics of the manager queue together with foremen information.
timestamp_t time_app_delay
Definition: work_queue.h:214
int exhausted_attempts
Number of times the task failed given exhausted resources.
Definition: work_queue.h:151
void work_queue_task_specify_command(struct work_queue_task *t, const char *cmd)
Indicate the command to be executed.
void work_queue_task_specify_running_time_max(struct work_queue_task *t, int64_t seconds)
Specify the maximum time (in seconds) the task is allowed to run in a worker.
int tasks_waiting
Number of tasks waiting to be dispatched.
Definition: work_queue.h:237
work_queue_task_state_t
Definition: work_queue.h:78
int workers_released
Total number of worker connections that were asked by the manager to disconnect.
Definition: work_queue.h:230
char * hostname
The name of the host on which it ran.
Definition: work_queue.h:142
void work_queue_invalidate_cached_file(struct work_queue *q, const char *local_name, work_queue_file_t type)
Invalidate cached file.
The task ran for more than the specified time (relative since running in a worker).
Definition: work_queue.h:72
Portable routines for high resolution timing.
double work_queue_get_effective_bandwidth(struct work_queue *q)
Get current queue bandwidth.
int work_queue_specify_category_mode(struct work_queue *q, const char *category, work_queue_category_mode_t mode)
Turn on or off first-allocation labeling for a given category.
int64_t total_gpus
Definition: work_queue.h:338
The task ran but failed to generate a specified output file.
Definition: work_queue.h:64
int64_t total_bytes_sent
Definition: work_queue.h:330
struct list * output_files
The output files (other than the standard output stream) created by the program to be retrieved from ...
Definition: work_queue.h:136
int priority
Definition: work_queue.h:344
int64_t total_bytes_transferred
Definition: work_queue.h:212
void work_queue_delete(struct work_queue *q)
Delete a work queue.
UINT64_T timestamp_t
A type to hold the current time, in microseconds since January 1st, 1970.
Definition: timestamp.h:20
struct list * env_list
Environment variables applied to the task.
Definition: work_queue.h:137
int tasks_complete
Definition: work_queue.h:314
int64_t min_gpus
Definition: work_queue.h:341
struct list * input_files
The files to transfer to the worker and place in the executing directory.
Definition: work_queue.h:135
double bandwidth
Average network bandwidth in MB/S observed by the manager when transferring to workers.
Definition: work_queue.h:272
struct work_queue_task * work_queue_cancel_by_tasktag(struct work_queue *q, const char *tag)
Cancel a submitted task using its tag and remove it from queue.
work_queue_task_state_t work_queue_task_state(struct work_queue *q, int taskid)
Get the current state of the task.
int capacity_gpus
The estimated number of workers&#39; GPUs that this manager can effectively support.
Definition: work_queue.h:279
int tasks_exhausted_attempts
Total number of task executions that failed given resource exhaustion.
Definition: work_queue.h:248
void work_queue_task_specify_running_time(struct work_queue_task *t, int64_t useconds)
Specify the maximum time (in microseconds) the task is allowed to run in a worker.
char * category
User-provided label for the task.
Definition: work_queue.h:144
double manager_load
In the range of [0,1].
Definition: work_queue.h:299
int total_tasks_complete
Definition: work_queue.h:317
void work_queue_specify_catalog_servers(struct work_queue *q, const char *hosts)
Specify the catalog server(s) the manager should report to.
struct work_queue_task * work_queue_wait(struct work_queue *q, int timeout)
Wait for a task to complete.
timestamp_t time_when_retrieval
The time when output files start to be transfered back to the manager.
Definition: work_queue.h:167
void work_queue_task_specify_memory(struct work_queue_task *t, int64_t memory)
Specify the amount of disk space required by a task.
char * command_line
The program(s) to execute, as a shell command line.
Definition: work_queue.h:132
timestamp_t total_cmd_exhausted_execute_time
Definition: work_queue.h:207
The task filled its loop device allocation but needed more space.
Definition: work_queue.h:73
There is no such task.
Definition: work_queue.h:79
int64_t committed_memory
Committed memory in MB aggregated across the connected workers.
Definition: work_queue.h:288
timestamp_t total_time_until_worker_failure
Definition: work_queue.h:208
int total_workers_removed
Definition: work_queue.h:309
File-spec is a regular file.
Definition: work_queue.h:89
Task is done, and returned through work_queue_wait &gt;
Definition: work_queue.h:84
The result could not be classified.
Definition: work_queue.h:69
struct work_queue * work_queue_ssl_create(int port, const char *key, const char *cert)
Create a new work queue using SSL.
void work_queue_unblock_host(struct work_queue *q, const char *hostname)
Unblock host from a queue.
Specify an output object.
Definition: work_queue.h:35
The task failed, but it was not a task error.
Definition: work_queue.h:70
int work_queue_specify_log(struct work_queue *q, const char *logfile)
Add a log file that records cummulative statistics of the connected workers and submitted tasks...
timestamp_t time_receive_output_finish
Definition: work_queue.h:198
Select worker that has the most data required by the task.
Definition: work_queue.h:54
int total_workers_fast_aborted
Definition: work_queue.h:312
timestamp_t time_task_submit
Definition: work_queue.h:189
void work_queue_task_specify_start_time_min(struct work_queue_task *t, int64_t useconds)
Specify the minimum start time allowed for the task (in microseconds since the Epoch).
timestamp_t time_receive_result_finish
Definition: work_queue.h:196
int work_queue_task_specify_input_buf(struct work_queue_task *t, const char *buf, int length, const char *rname)
Add an input buffer to a task.
int64_t committed_cores
Committed number of cores aggregated across the connected workers.
Definition: work_queue.h:287
void work_queue_specify_catalog_server(struct work_queue *q, const char *hostname, int port)
Specify the catalog server the manager should report to.
char * host
The address and port of the host on which it ran.
Definition: work_queue.h:141
timestamp_t time_when_commit_end
The time when the task is completely transfered to a worker.
Definition: work_queue.h:165
int work_queue_port(struct work_queue *q)
Get the listening port of the queue.
work_queue_schedule_t
Definition: work_queue.h:51
int work_queue_specify_password_file(struct work_queue *q, const char *file)
Add a mandatory password file that each worker must present.
Access the file on the client from a shared filesystem (same as WORK_QUEUE_THIRDGET, included for readability)
Definition: work_queue.h:43
int taskid
A unique task id number.
Definition: work_queue.h:138
int fast_abort_count
Number of times this task has been terminated for running too long.
Definition: work_queue.h:152
int avg_capacity
Definition: work_queue.h:348
int workers_busy
Number of workers that are running at least one task.
Definition: work_queue.h:224
void work_queue_task_specify_running_time_min(struct work_queue_task *t, int64_t seconds)
Specify the minimum time (in seconds) the task is expected to run in a worker.
timestamp_t time_polling
Total time blocking waiting for worker communications (i.e., manager idle waiting for a worker messag...
Definition: work_queue.h:261
struct work_queue_task * work_queue_task_create(const char *full_command)
Create a new task object.
File-spec refers to an URL.
Definition: work_queue.h:94
As above, but tasks are first tried with an automatically computed allocation to minimize resource wa...
Definition: work_queue.h:112
void work_queue_specify_password(struct work_queue *q, const char *password)
Add a mandatory password that each worker must present.
int capacity_tasks
The estimated number of tasks that this manager can effectively support.
Definition: work_queue.h:275
struct rmsummary * resources_measured
When monitoring is enabled, it points to the measured resources used by the task in its latest attemp...
Definition: work_queue.h:179
timestamp_t time_status_msgs
Total time spent sending and receiving status messages to and from workers, including workers&#39; standa...
Definition: work_queue.h:259
timestamp_t time_committed
Definition: work_queue.h:191
int workers_fast_aborted
Total number of worker connections terminated for being too slow.
Definition: work_queue.h:232
void work_queue_unblock_all(struct work_queue *q)
Unblock all host.
int port
Definition: work_queue.h:343
work_queue_schedule_t worker_selection_algorithm
How to choose worker to run the task.
Definition: work_queue.h:133
The task ran successfully.
Definition: work_queue.h:62
int64_t total_bytes_received
Definition: work_queue.h:331
void work_queue_task_specify_tag(struct work_queue_task *t, const char *tag)
Attach a user defined string tag to the task.
timestamp_t time_workers_execute_failure
Accumulated time for runs that terminated in worker failure/disconnection.
Definition: work_queue.h:172
timestamp_t time_when_done
The time at which the task is mark as retrieved, after transfering output files and other final proce...
Definition: work_queue.h:157
int total_tasks_cancelled
Definition: work_queue.h:319
Create a symlink to the file rather than copying it, if possible.
Definition: work_queue.h:41
category_allocation_t
Valid states for the lifetime of automatic resource allocations for a single task.
Definition: category.h:21
struct rmsummary * resources_allocated
Resources allocated to the task its latest attempt.
Definition: work_queue.h:178
void work_queue_task_specify_priority(struct work_queue_task *t, double priority)
Specify the priority of this task relative to others in the queue.
The task failed because the monitor did not produce a summary report.
Definition: work_queue.h:74
int max_retries
Number of times the task is tried to be executed on some workers until success.
Definition: work_queue.h:148
struct rmsummary * resources_requested
Number of cores, disk, memory, time, etc.
Definition: work_queue.h:180
File-spec is a regular file.
Definition: work_queue.h:91
work_queue_result_t result
The result of the task (see work_queue_result_t.
Definition: work_queue.h:140
void work_queue_task_specify_max_retries(struct work_queue_task *t, int64_t max_retries)
Specify the number of times this task is retried on worker errors.
struct work_queue_task * work_queue_task_clone(const struct work_queue_task *task)
Create a copy of a task Create a functionally identical copy of a work_queue_task that can be re-sub...
int work_queue_empty(struct work_queue *q)
Determine whether the queue is empty.
Only return this output file if the task failed.
Definition: work_queue.h:45
int tasks_failed
Total number of tasks completed and returned to user with result other than WQ_RESULT_SUCCESS.
Definition: work_queue.h:246
void work_queue_task_specify_disk(struct work_queue_task *t, int64_t disk)
Specify the amount of disk space required by a task.
int work_queue_shut_down_workers(struct work_queue *q, int n)
Shut down workers connected to the work_queue system.
void work_queue_task_specify_algorithm(struct work_queue_task *t, work_queue_schedule_t algorithm)
Select the scheduling algorithm for a single task.
work_queue_file_type_t
Definition: work_queue.h:33
int64_t min_memory
The smallest memory size in MB observed among the connected workers.
Definition: work_queue.h:296
void work_queue_set_bandwidth_limit(struct work_queue *q, const char *bandwidth)
Limit the queue bandwidth when transferring files to and from workers.
struct rmsummary ** work_queue_workers_summary(struct work_queue *q)
Summary data for all workers in buffer.
void work_queue_task_specify_category(struct work_queue_task *t, const char *category)
Label the task with the given category.
work_queue_result_t
Definition: work_queue.h:61
timestamp_t time_workers_execute_good
Total time workers spent executing done tasks with result WQ_RESULT_SUCCESS.
Definition: work_queue.h:266
Cache file at execution site for later use.
Definition: work_queue.h:40
int64_t bytes_transferred
Number of bytes transferred since task has last started transferring input data.
Definition: work_queue.h:176
int total_workers_idled_out
Definition: work_queue.h:311
File-spec is a directory.
Definition: work_queue.h:93
The task ran after the specified (absolute since epoch) end time.
Definition: work_queue.h:68
const char * work_queue_name(struct work_queue *q)
Get the project name of the queue.
int total_workers_lost
Definition: work_queue.h:310
double priority
The priority of this task relative to others in the queue: higher number run earlier.
Definition: work_queue.h:147
void work_queue_get_stats_category(struct work_queue *q, const char *c, struct work_queue_stats *s)
Get the task statistics for the given category.
timestamp_t time_workers_execute_exhaustion
Total time workers spent executing tasks that exhausted resources.
Definition: work_queue.h:267
int tasks_submitted
Total number of tasks submitted to the queue.
Definition: work_queue.h:243
void work_queue_specify_keepalive_timeout(struct work_queue *q, int timeout)
Change the keepalive timeout for identifying dead workers for a given queue.
int work_queue_enable_monitoring(struct work_queue *q, char *monitor_output_directory, int watchdog)
Enables resource monitoring on the give work queue.
const char * work_queue_result_str(work_queue_result_t result)
Explain result codes from tasks.
void work_queue_specify_num_tasks_left(struct work_queue *q, int ntasks)
Specify the number of tasks not yet submitted to the queue.
Watch the output file and send back changes as the task runs.
Definition: work_queue.h:44
int64_t min_running_time
Minimum time (in seconds) the task needs to run.
Definition: work_queue.h:161
Statistics describing a work queue.
Definition: work_queue.h:219
Definition: rmsummary.h:26
As above, but maximizing throughput.
Definition: category.h:46
timestamp_t time_when_commit_start
The time when the task starts to be transfered to a worker.
Definition: work_queue.h:164
int capacity_disk
The estimated number of workers&#39; MB of disk that this manager can effectively support.
Definition: work_queue.h:278
void work_queue_specify_category_min_resources(struct work_queue *q, const char *category, const struct rmsummary *rm)
Sets the minimum resources a task in the category may use.
void work_queue_specify_max_resources(struct work_queue *q, const struct rmsummary *rm)
Sets the maximum resources a task without an explicit category (&quot;default&quot; category).
timestamp_t time_receive_result_start
Definition: work_queue.h:195
int return_status
The exit code of the command line.
Definition: work_queue.h:139
Select worker on a first-come-first-serve basis.
Definition: work_queue.h:53
int64_t bytes_sent
Total number of file bytes (not including protocol control msg bytes) sent out to the workers by the ...
Definition: work_queue.h:270
int64_t min_cores
The lowest number of cores observed among the connected workers.
Definition: work_queue.h:295
int64_t max_gpus
Definition: work_queue.h:340
Access the file on the client from a shared filesystem.
Definition: work_queue.h:42
void work_queue_task_specify_gpus(struct work_queue_task *t, int gpus)
Specify the number of gpus required by a task.
int total_workers_connected
Definition: work_queue.h:307
timestamp_t total_receive_time
Definition: work_queue.h:323
int work_queue_enable_monitoring_full(struct work_queue *q, char *monitor_output_directory, int watchdog)
Enables resource monitoring on the give work queue.
int tasks_with_results
Number of tasks with retrieved results and waiting to be returned to user.
Definition: work_queue.h:240
int work_queue_hungry(struct work_queue *q)
Determine whether the queue is &#39;hungry&#39; for more tasks.
The task could not be completed successfully in the given number of retries.
Definition: work_queue.h:71
int work_queue_activate_fast_abort_category(struct work_queue *q, const char *category, double multiplier)
Turn on or off fast abort functionality for a given category.
Task has been dispatched to some worker.
Definition: work_queue.h:81
int work_queue_tune(struct work_queue *q, const char *name, double value)
Tune advanced parameters for work queue.
void work_queue_block_host(struct work_queue *q, const char *hostname)
Block workers in hostname from working for queue q.
int64_t total_cores
Total number of cores aggregated across the connected workers.
Definition: work_queue.h:283
Select a random worker.
Definition: work_queue.h:56
void work_queue_specify_min_resources(struct work_queue *q, const struct rmsummary *rm)
Sets the minimum resources a task without an explicit category (&quot;default&quot; category).
The task cannot be run due to a missing input file.
Definition: work_queue.h:63
int tasks_done
Total number of tasks completed and returned to user.
Definition: work_queue.h:245
double capacity
Definition: work_queue.h:333
int total_worker_slots
Definition: work_queue.h:347
struct work_queue_task * work_queue_wait_for_tag(struct work_queue *q, const char *tag, int timeout)
Wait for a task with a given task to complete.
timestamp_t time_internal
Total time the queue spents in internal processing.
Definition: work_queue.h:260
int64_t max_disk
The largest disk space in MB observed among the connected workers.
Definition: work_queue.h:293
Select worker that has the fastest execution time on previous tasks.
Definition: work_queue.h:55
timestamp_t total_transfer_time
Definition: work_queue.h:203
double idle_percentage
Definition: work_queue.h:336
Task was canceled before completion.
Definition: work_queue.h:85
void work_queue_task_specify_environment_variable(struct work_queue_task *t, const char *name, const char *value)
Specify an environment variable to be added to the task.
int work_queue_activate_fast_abort(struct work_queue *q, double multiplier)
Turn on or off fast abort functionality for a given queue for tasks without an explicit category...
int64_t total_disk
Total disk space in MB aggregated across the connected workers.
Definition: work_queue.h:285
char * tag
An optional user-defined logical name for the task.
Definition: work_queue.h:131
timestamp_t time_when_started
Absolute time at which the manager started.
Definition: work_queue.h:254
timestamp_t total_execute_time
Definition: work_queue.h:326
int work_queue_submit(struct work_queue *q, struct work_queue_task *t)
Submit a task to a queue.
timestamp_t time_execute_cmd_finish
Definition: work_queue.h:201
Select the worst fit worker (the worker with more unused resources).
Definition: work_queue.h:57
int workers_idled_out
Total number of worker that disconnected for being idle.
Definition: work_queue.h:231
double efficiency
Definition: work_queue.h:335
void work_queue_specify_keepalive_interval(struct work_queue *q, int interval)
Change the keepalive interval for a given queue.
The task was terminated with a signal.
Definition: work_queue.h:66
timestamp_t time_task_finish
Definition: work_queue.h:190
int work_queue_task_specify_input_file(struct work_queue_task *t, const char *fname, const char *rname)
Add an input file to a task.
int workers_able
Number of workers on which the largest task can run.
Definition: work_queue.h:225
timestamp_t time_execute_cmd_start
Definition: work_queue.h:200
char * monitor_snapshot_file
Filename the monitor checks to produce snapshots.
Definition: work_queue.h:183
int workers_idle
Number of workers that are not running a task.
Definition: work_queue.h:223
int wq_option_scheduler
Initial setting for algorithm to assign tasks to workers upon creating queue .
void work_queue_task_specify_end_time(struct work_queue_task *t, int64_t useconds)
Specify the maximum end time allowed for the task (in microseconds since the Epoch).
timestamp_t time_send
Total time spent in sending tasks to workers (tasks descriptions, and input files.).
Definition: work_queue.h:255
int workers_blocked
Total number of workers blocked by the manager.
Definition: work_queue.h:233
int work_queue_specify_snapshot_file(struct work_queue_task *t, const char *monitor_snapshot_file)
When monitoring, indicates a json-encoded file that instructs the monitor to take a snapshot of the ...
void work_queue_specify_category_max_resources(struct work_queue *q, const char *category, const struct rmsummary *rm)
Sets the maximum resources a task in the category may use.
int64_t total_bytes_sent
Definition: work_queue.h:211
timestamp_t total_send_time
Definition: work_queue.h:322
work_queue_file_t
Definition: work_queue.h:88
char * work_queue_get_worker_summary(struct work_queue *q)
Summarize workers.
void work_queue_initialize_categories(struct work_queue *q, struct rmsummary *max, const char *summaries_file)
Initialize first value of categories.
void work_queue_specify_priority(struct work_queue *q, int priority)
Change the priority for a given queue.
int capacity_instantaneous
The estimated number of tasks that this manager can support considering only the most recently comple...
Definition: work_queue.h:280
int64_t total_bytes_received
Definition: work_queue.h:210
int total_tasks_failed
Definition: work_queue.h:318
work_queue_category_mode_t
Here we repeat the category_mode_t declaration but with work_queue names.
Definition: work_queue.h:100
Data comes from buffer memory.
Definition: work_queue.h:90
timestamp_t time_receive
Total time spent in receiving results from workers (output files.).
Definition: work_queue.h:256
int work_queue_specify_transactions_log(struct work_queue *q, const char *logfile)
Add a log file that records the states of the connected workers and tasks.
int64_t max_memory
The largest memory size in MB observed among the connected workers.
Definition: work_queue.h:292
void work_queue_task_specify_monitor_output(struct work_queue_task *t, const char *monitor_output)
Specify a custom name for the monitoring summary.
void work_queue_task_delete(struct work_queue_task *t)
Delete a task.
int work_queue_task_specify_buffer(struct work_queue_task *t, const char *data, int length, const char *remote_name, work_queue_file_flags_t flags)
Add an input buffer to a task.
int work_queue_task_specify_file(struct work_queue_task *t, const char *local_name, const char *remote_name, work_queue_file_type_t type, work_queue_file_flags_t flags)
Add a file to a task.
timestamp_t time_workers_execute_exhaustion
Accumulated time spent in attempts that exhausted resources.
Definition: work_queue.h:171
char * output
The standard output of the task.
Definition: work_queue.h:134
work_queue_file_flags_t
Definition: work_queue.h:38
timestamp_t time_application
Total time spent outside work_queue_wait.
Definition: work_queue.h:262
void work_queue_specify_category_first_allocation_guess(struct work_queue *q, const char *category, const struct rmsummary *rm)
Set the initial guess for resource autolabeling for the given category.
The task used more resources than requested.
Definition: work_queue.h:67
void work_queue_specify_name(struct work_queue *q, const char *name)
Change the project name for a given queue.
File-spec refers to only a part of a file.
Definition: work_queue.h:92
When monitoring is disabled, all tasks run as WORK_QUEUE_ALLOCATION_MODE_FIXED.
Definition: category.h:36
int workers_ready
Definition: work_queue.h:345
void work_queue_specify_algorithm(struct work_queue *q, work_queue_schedule_t algorithm)
Change the worker selection algorithm.
Do not cache file at execution site.
Definition: work_queue.h:39
char * work_queue_generate_disk_alloc_full_filename(char *pwd, int taskid)
Generate a worker-level unique filename to indicate a disk allocation being full. ...
Specify an input object.
Definition: work_queue.h:34
Definition: category.h:52
int capacity_weighted
The estimated number of tasks that this manager can support placing greater weight on the most recent...
Definition: work_queue.h:281
int64_t max_cores
The highest number of cores observed among the connected workers.
Definition: work_queue.h:291
int tasks_cancelled
Total number of tasks cancelled.
Definition: work_queue.h:247
The task ran but its stdout has been truncated.
Definition: work_queue.h:65