Content-type: text/html Man page of assign_pid_to_pset

assign_pid_to_pset

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

NAME

assign_pid_to_pset - Assigns a process identification number to a processor set  

LIBRARY

Pset Library (libpset.a)

Mach Library (libmach.a)  

SYNOPSIS

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

int assign_pid_to_pset(
        pid_t pid_list,
        long num_pids,
        long pset_id ,
        long flags )  

PARAMETERS

List of process identification numbers to assign to the specified processor set. Number of process identification numbers in the list specified by the pid_list variable. Processor set, which is returned by a successful create_pset call. Mask of options. Currently this function supports only the PSET_EXCLUSIVE option.  

DESCRIPTION

The assign_pid_to_pset function assigns the process identification number specified by the pid_list variable to the processor set specified by the pset_id variable. This function requires root privileges.  

RETURN VALUES

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

To enable exclusive use of a processor set, set the PSET_EXCLUSIVE bit in the mask of options specified by the flags variable. If the processor set is being used by another process, a request for exclusive access returns an error, and exclusive access is not enabled.  

RELATED INFORMATION

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


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
RELATED INFORMATION

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