Content-type: text/html Man page of assign_cpu_to_pset

assign_cpu_to_pset

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

assign_cpu_to_pset - Assigns a processor to a processor set  

LIBRARY

Pset Library (libpset.a)

Mach Library (libmach.a)  

SYNOPSIS

#include <sys/types.h> #include <sys/processor.h>

int assign_cpu_to_pset(
        long cpu,
        long pset_id ,
        long option );  

PARAMETERS

Processor or processors to assign to the specified processor set. Processor set identifier, which is returned by the create_pset function. Specifies a bit mask. Currently, only the ANY_CPU bit is supported. If this bit is set, the value specified by the cpu variable is the number of processors to be assigned to the specified processor set from the default processor set. If the ANY_CPU bit is not set, the value specified by the cpu variable is the mask of processors to be assigned to the processor set.  

DESCRIPTION

The assign_cpu_to_pset function removes processors from their current processor set and assigns them to the processor set specified by the pset_id variable. This function requires root privileges.

If the ANY_CPU option is specified, the number of processors specified by the cpu variable are assigned from the default processor set to the processor set that is specified with the pset_id variable. If the specified number of processors are not available in the default processor set, an error is returned and no processors are assigned.

If the ANY_CPU option is not set, the value specified by the cpu variable is a mask of processors to be assigned to the specified processor set. For example, if you specify a cpu value of 6, then processors 2 and 3 are assigned to the processor set.

Processor assignments are logged in the /var/adm/wtmp file.  

RETURN VALUES

If the processor assignment is successful, the assign_cpu_to_pset function returns zero (0). If the assignment is unsuccessful, the function returns a negative number. Use the print_pset_error function to print a message that describes the error.  

FILES

/var/adm/wtmp  

RELATED INFORMATION

bind_to_cpu(3), create_pset(3), destroy_pset(3), assign_pid_to_pset(3), print_pset_error(3), processor_sets(4), pset_create(1) delim off


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
FILES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:05 GMT, October 02, 2010