GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SLURM_SET_TRIGGER (3)

NAME

slurm_init_trigger_msg, slurm_clear_trigger, slurm_free_trigger_msg, slurm_get_triggers, slurm_set_trigger - Slurm event trigger management functions

CONTENTS

SYNTAX

#include <slurm/slurm.h>

int slurm_set_trigger (
        trigger_info_t *trigger_info
);

int slurm_clear_trigger (
        trigger_info_t *trigger_info
);

int slurm_get_triggers (
        trigger_info_msg_t **trigger_info_msg
);

int slurm_free_trigger (
        trigger_info_msg_t *trigger_info_msg
);

int slurm_init_trigger_msg (
        trigger_info_msg_t *trigger_info_msg
);

ARGUMENTS

trigger_info
  Information about one event trigger including trigger ID, type, time offset, etc. See slurm.h for details.
trigger_info_msg
  A data structure including an array of trigger_info structures plus their count. See slurm.h for details.

DESCRIPTION

slurm_set_trigger Create a new event trigger. Note that any trigger ID specified in trigger_info is unused.

slurm_clear_trigger Clear or remove existing event triggers. If a trigger ID is specified then only that one trigger will be cleared. If a job ID or node name is specified, then all triggers associated with that resource are cleared.

slurm_get_triggers Get information about all currently configured event triggers. To avoid memory leaks, always follow this with a call to the slurm_free_trigger function.

slurm_free_trigger Release the memory allocated for the array returned by the slurm_get_triggers function.

slurm_init_trigger_msg Initialize the data structure to be used in subsequent call to slurm_set_trigger or slurm_clear_trigger.

RETURN VALUE

SLURM_SUCCESS is returned on successful completion, otherwise an error code is returned as described below.

ERRORS

EINVAL Invalid argument

ESLURM_ACCESS_DENIED Attempt by non-privileged user to set an event trigger.

ESLURM_ALREADY_DONE Attempt to set an event trigger for a job which has already completed.

ESLURM_INVALID_NODE_NAME Attempt to set an event trigger for a node name which is invalid.

ESLURM_INVALID_JOB_ID the specified job id does not exist.

ESLURM_TRIGGER_DUP there is already an identical event trigger.

NOTE

These functions are included in the libslurm library, which must be linked to your process for use (e.g. "cc -lslurm myprog.c").

COPYING

Copyright (C) 2010 Lawrence Livermore National Security. Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER). Portions Copyright (C) 2014 SchedMD LLC.

This file is part of Slurm, a resource management program. For details, see <http://slurm.schedmd.com/>.

Slurm is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

Slurm is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

SEE ALSO

strigger(1), slurm_get_errno(3), slurm_perror(3), slurm_strerror(3)

Search for    or go to Top of page |  Section 3 |  Main Index


April 2015 SLURM API (3) Slurm event trigger management functions

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.