SLURM Preemption Plugin API

Overview

This document describes SLURM preemption plugins and the API that defines them. It is intended as a resource to programmers wishing to write their own SLURM preemption plugins. This is version 100 of the API.

SLURM preemption plugins are SLURM plugins that identify which jobs can be preempted by a pending job. They must conform to the SLURM Plugin API with the following specifications:

const char plugin_type[]="major/minor"
The major type must be "preempt." The minor type can be any recognizable abbreviation for the type of preemption. We recommend, for example:

The plugin_name and plugin_version symbols required by the SLURM Plugin API require no specialization for job preemption support. Note carefully, however, the versioning discussion below.

The programmer is urged to study src/plugins/preempt/partition_prio/preempt_partition_prio.c for an example implementation of a SLURM preemption plugin.

API Functions

The following functions must appear. Functions which are not implemented should be stubbed.

List find_preemptable_jobs( struct job_record *job_ptr)

Description: Identifies the jobs which can be preempted by a specific pending job.

Arguments:
job_ptr (input) a pointer to the pending job which is attempting to be started

Returns: A list of pointers to jobs which may be preempted. The list should be be released using the list_destroy function when no longer required. This list should be sorted in order from most attractive to preempt to least attractive to preempt (e.g. lowest to highest priority). For example, even within a given partition or QOS one might want to smaller jobs first.

uint16_t job_preempt_mode( struct job_record *job_ptr)

Description: Identifies the mechanism used to preempt the specified job.

Arguments:
job_ptr (input) a pointer to the running job to be preempted

Returns: PREEMPT_MODE as defined in the slurm/slurm.h file

bool preemption_enabled(void)

Description: Report whether or not job preemption is enabled.

Returns: true if running jobs may be preempted, otherwise false

Versioning

This document describes version 100 of the SLURM Preemption API. Future releases of SLURM may revise this API. A preemption plugin conveys its ability to implement a particular API version using the mechanism outlined for SLURM plugins.

Last modified 22 May 2010