topology.conf(5) [debian man page]

topology.conf(5)					     Slurm configuration file						  topology.conf(5)

NAME

       topology.conf - Slurm configuration file for defining the network topology

DESCRIPTION

       topology.conf is an ASCII file which describes the cluster's network topology for optimized job resource allocation.  The file location can
       be modified at system build time using the DEFAULT_SLURM_CONF parameter or at execution time by setting the  SLURM_CONF	environment  vari-
       able. The file will always be located in the same directory as the slurm.conf file.

       Parameter  names  are case insensitive.	Any text following a "#" in the configuration file is treated as a comment through the end of that
       line.  The size of each line in the file is limited to 1024 characters.	Changes to the configuration file  take  effect  upon  restart	of
       SLURM daemons, daemon receipt of the SIGHUP signal, or execution of the command "scontrol reconfigure" unless otherwise noted.

       The  network  topology  configuration  one  one	line  defining a switch name and its children, either node names or switch names.  SLURM's
       hostlist expression parser  is  used,  so  the  node  and  switch  names  need  not  be	consecutive  (e.g.  "Nodes=tux[0-3,12,18-20]"  and
       "Switches=s[0-2,4-8,12]" will parse fine).  An optional link speed may also be specified.

       The overall configuration parameters available include:

       SwitchName
	      The  name  of  a	switch.  This name is internal to SLURM and arbitrary.	Each switch should have a unique name.	This field must be
	      specified.

       Switches
	      Child switches of the named switch.  Either this option or the Nodes option must be specified.

       Nodes  Child Nodes of the named leaf switch.  Either this option or the Switches option must be specified.

       LinkSpeed
	      An optional value specifying the performance of this communication link.	The units used are arbitrary and this information is  cur-
	      rently not used.	It may be used in the future to optimize resource allocations.

EXAMPLE

       ##################################################################
       # SLURM's network topology configuration file for use with the
       # topology/tree plugin
       ##################################################################
       SwitchName=s0 Nodes=dev[0-5]
       SwitchName=s1 Nodes=dev[6-11]
       SwitchName=s2 Nodes=dev[12-17]
       SwitchName=s3 Switches=s[0-2]

COPYING

       Copyright  (C)  2009  Lawrence  Livermore  National  Security.	Produced  at  Lawrence	Livermore  National  Laboratory  (cf, DISCLAIMER).
       CODE-OCEC-09-009. All rights reserved.

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

       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

       slurm.conf(5)

topology.conf 2.0						    March 2009							  topology.conf(5)

Check Out this Related Man Page

Slurm API(3)					    Slurm suspend, resume and requeue functions 				      Slurm API(3)

NAME

       slurm_suspend, slurm_resume, slurm_requeue - Slurm suspend, resume and requeue functions

SYNTAX

       #include <slurm/slurm.h>

       int slurm_suspend (
	    uint32_t job_id
       );

       int slurm_resume (
	    uint32_t job_id
       );

       int slurm_requeue (
	       uint32_t job_id
       );

ARGUMENTS

       job_id SLURM job ID to perform the operation upon.

DESCRIPTION

       slurm_suspend Suspend the specified job.

       slurm_resume Resume execution of a previously suspended job.

       slurm_requeue  Requeue  a  running  or pending SLURM batch job.	The job script will be restarted from its beginning, ignoring any previous
       checkpoint.

RETURN VALUE

       Zero is returned upon success.  On error, -1 is returned, and the Slurm error code is set appropriately.

ERRORS

       ESLURM_DISABLED the operation is currently disabled (e.g. attempt to suspend a job that is not running, resume a job that is not  currently
       suspended, or requeue a job on which the operation has been disabled).

       ESLURM_INVALID_JOB_ID the requested job id does not exist.

       ESLURM_ACCESS_DENIED the requesting user lacks authorization for the requested action (e.g. not user root or SlurmUser).

       ESLURM_JOB_PENDING the requested job is still pending.

       ESLURM_ALREADY_DONE the requested job has already completed.

       ESLURM_NOT_SUPPORTED the requested operation is not supported on this system.

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) 2005-2006 The Regents of the University of California.  Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER).
       CODE-OCEC-09-009. All rights reserved.

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

       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

       scontrol(1)

Morris Jette							     May 2006							      Slurm API(3)

Linux and UNIX Man Pages

topology.conf(5) [debian man page]

Check Out this Related Man Page