src/common/tres_bind.c

/*****************************************************************************\
 *  tres_bind.c - Perform TRES binding functions
 *****************************************************************************
 *  Copyright (C) SchedMD LLC.
 *  Written by Morris Jette
 *
 *  This file is part of Slurm, a resource management program.
 *  For details, see <https://slurm.schedmd.com/>.
 *  Please also read the included file: DISCLAIMER.
 *
 *  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.
 *
 *  In addition, as a special exception, the copyright holders give permission
 *  to link the code of portions of this program with the OpenSSL library under
 *  certain conditions as described in each individual source file, and
 *  distribute linked combinations including the two. You must obey the GNU
 *  General Public License in all respects for all of the code used other than
 *  OpenSSL. If you modify file(s) with this exception, you may extend this
 *  exception to your version of the file(s), but you are not obligated to do
 *  so. If you do not wish to do so, delete this exception statement from your
 *  version.  If you delete this exception statement from all source files in
 *  the program, then also delete it here.
 *
 *  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.
 *
 *  You should have received a copy of the GNU General Public License along
 *  with Slurm; if not, write to the Free Software Foundation, Inc.,
 *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA.
\*****************************************************************************/

#include <limits.h>	/* For LONG_MIN, LONG_MAX */
#include <stdlib.h>
#include <ctype.h>

#include "src/common/xstring.h"
#include "src/interfaces/gres.h"
#include "src/slurmd/slurmd/slurmd.h"
#include "src/slurmd/slurmstepd/slurmstepd_job.h"

static int _valid_num(const char *arg)
{
	long int val = strtol(arg, NULL, 0);
	if ((val < 0) || (val == LONG_MAX))
		return -1;
	return 0;
}

/*
 * Test for valid comma-delimited set of numbers
 * RET - -1 on error, else 0
 */
static int _valid_num_list(const char *arg, bool hex)
{
	char *tmp, *tok, *end_ptr = NULL, *save_ptr = NULL;
	long int val;
	int rc = 0;
	int base = 10;
	int (*isvalid)(int) = isdigit;

	if (hex) {
		isvalid = isxdigit;
		base = 16;
	}

	tmp = xstrdup(arg);
	tok = strtok_r(tmp, ",", &save_ptr);
	while (tok) {
		if (hex && !xstrncmp(tok, "0x", 2))
			tok += 2;
		for (int i = 0; tok[i]; i++)
			if (!isvalid(tok[i]) && (tok[i] != '*')) {
				error("Failed to validate %s, offending character is %c",
				      tok, tok[i]);
				return -1;
			}

		val = strtol(tok, &end_ptr, base);
		if ((val < 0) || (val == LONG_MAX) ||
		    ((end_ptr[0] != '\0') && (end_ptr[0] != '*'))) {
			rc = -1;
			break;
		}
		if (end_ptr[0] == '*') {
			val = strtol(end_ptr+1, &end_ptr, 0);
			if ((val < 0) || (val == LONG_MAX) ||
			    (end_ptr[0] != '\0')) {
				rc = -1;
				break;
			}
		}
		tok = strtok_r(NULL, ",", &save_ptr);
	}
	xfree(tmp);

	return rc;
}

/*
 * Test for valid gres binding specification
 * RET - -1 on error, else 0
 */
static int _valid_gres_bind(char *arg)
{
	if (!strncasecmp(arg, "verbose,", 8))
		arg += 8;
	if (!xstrncasecmp(arg, "closest", 7))
		return 0;
	if (!xstrncasecmp(arg, "map_gpu:", 8) || //Old syntax
	    !xstrncasecmp(arg, "map:", 4))
		return _valid_num_list(arg + 8, false);
	if (!xstrncasecmp(arg, "mask_gpu:", 9) || //Old syntax
	    !xstrncasecmp(arg, "mask:", 5))
		return _valid_num_list(arg + 9, true);
	if (!xstrncasecmp(arg, "none", 4))
		return 0;
	if (!xstrncasecmp(arg, "per_task:", 9))
		return _valid_num(arg + 9);
	if (!xstrncasecmp(arg, "single:", 7))
		return _valid_num(arg + 7);
	return -1;
}

/*
 * Test for valid shared gres binding specification
 * RET - -1 on error, else 0
 */
static int _valid_shared_gres_bind(char *arg)
{
	if (!strncasecmp(arg, "verbose,", 8))
		arg += 8;
	if (!xstrncasecmp(arg, "none", 4))
		return 0;
	if (!xstrncasecmp(arg, "per_task:", 9))
		return _valid_num(arg + 9);
	return -1;
}

/*
 * Verify --tres-bind command line option
 * NOTE: Separate TRES specifications with "+" rather than ","
 *
 * arg IN - Parameter value to check
 * RET - -1 on error, else 0
 *
 * Example: gres/gpu:closest
 *          gres/gpu:single:2
 *          gres/gpu:map:0,1
 *          gres/gpu:mask:0x3,0x3s
 *          gres/gpu:map:0,1+nic:closest
 */
extern int tres_bind_verify_cmdline(const char *arg)
{
	char *sep, *save_ptr = NULL, *tmp, *tok;
	int rc = 0;

	if ((arg == NULL) || (arg[0] == '\0'))
		return 0;

	tmp = xstrdup(arg);
	tok = strtok_r(tmp, "+", &save_ptr);
	while (tok) {
		sep = strchr(tok, ':');		/* Bad format */
		if (!sep) {
			rc = -1;
			break;
		}
		sep[0] = '\0';
		sep++;
		if (!xstrncmp(tok, "gres/", 5)) {
			if (gres_is_shared_name(tok + 5)) {
				if (_valid_shared_gres_bind(sep) != 0) {
					rc = -1;
					break;
				}
			} else {
				if (_valid_gres_bind(sep) != 0) {
					rc = -1;
					break;
				}
			}
		} else {
			rc = -1;
			break;
		}
		tok = strtok_r(NULL, "+", &save_ptr);
	}
	xfree(tmp);

	return rc;
}