NAME

cpuset_parselist — utility functions for cpuset(2) handling

LIBRARY

System Utilities Library (libutil, -lutil)

SYNOPSIS

#include <sys/cpuset.h>
#include <libutil.h>

int
cpuset_parselist(const char *cpu-list, cpuset_t *mask);

DESCRIPTION

The cpuset_parselist() function parses a cpu-list filling the mask.

The cpu-list may include numbers separated by '-' for ranges and commas separating individual numbers. A special list of “all” may be specified in which case the list includes all CPUs from the root set.

RETURN VALUES

Return values can be the following

CPUSET_PARSE_OK

The parsing was successful

CPUSET_PARSE_ERROR

The cpu-list format is invalid

CPUSET_PARSE_GETAFFINITY

The cpuset_getaffinity(2) call has failed

CPUSET_PARSE_INVALID_CPU

The number of supported CPUs has been exceeded. The maximum number being CPU_SETSIZE.

SEE ALSO

cpuset(1), cpuset(2), cpuset(9)

AUTHORS

Jeffrey Roberson <jeff@FreeBSD.org>