Movatterモバイル変換

Document Information

Preface

Introduction

System Calls

access(2)

acct(2)

acl(2)

adjtime(2)

alarm(2)

brk(2)

chdir(2)

chmod(2)

chown(2)

chroot(2)

close(2)

creat(2)

dup(2)

exec(2)

execl(2)

execle(2)

execlp(2)

execv(2)

execve(2)

execvex(2)

execvp(2)

_Exit(2)

_exit(2)

exit(2)

faccessat(2)

facl(2)

fchdir(2)

fchmod(2)

fchmodat(2)

fchown(2)

fchownat(2)

fchroot(2)

fcntl(2)

fexecve(2)

fgetlabel(2)

fork1(2)

fork(2)

forkall(2)

forkallx(2)

forkx(2)

fpathconf(2)

fstat(2)

fstatat(2)

fstatvfs(2)

futimens(2)

futimesat(2)

getacct(2)

getcontext(2)

getdents(2)

getegid(2)

geteuid(2)

getgid(2)

getgroups(2)

getisax(2)

getitimer(2)

getlabel(2)

getmsg(2)

getpflags(2)

getpgid(2)

getpgrp(2)

getpid(2)

getpmsg(2)

getppid(2)

getppriv(2)

getprojid(2)

getrctl(2)

getrlimit(2)

getsid(2)

gettaskid(2)

getuid(2)

getustack(2)

ioctl(2)

issetugid(2)

kill(2)

lchown(2)

link(2)

linkat(2)

llseek(2)

lseek(2)

lstat(2)

_lwp_cond_broadcast(2)

_lwp_cond_reltimedwait(2)

_lwp_cond_signal(2)

_lwp_cond_timedwait(2)

_lwp_cond_wait(2)

_lwp_continue(2)

_lwp_info(2)

_lwp_kill(2)

_lwp_mutex_lock(2)

_lwp_mutex_trylock(2)

_lwp_mutex_unlock(2)

_lwp_self(2)

_lwp_sema_init(2)

_lwp_sema_post(2)

_lwp_sema_trywait(2)

_lwp_sema_wait(2)

_lwp_suspend(2)

memcntl(2)

meminfo(2)

mincore(2)

mkdir(2)

mkdirat(2)

mknod(2)

mknodat(2)

mmap(2)

mmapobj(2)

mount(2)

mprotect(2)

msgctl(2)

msgget(2)

msgids(2)

msgrcv(2)

msgsnap(2)

msgsnd(2)

munmap(2)

nice(2)

ntp_adjtime(2)

ntp_gettime(2)

open(2)

openat(2)

pathconf(2)

pause(2)

pcsample(2)

pipe(2)

poll(2)

p_online(2)

ppoll(2)

pread(2)

priocntl(2)

priocntlset(2)

processor_bind(2)

processor_info(2)

profil(2)

pset_assign(2)

pset_bind(2)

pset_destroy(2)

pset_getattr(2)

pset_info(2)

pset_list(2)

pset_setattr(2)

putacct(2)

putmsg(2)

putpmsg(2)

pwrite(2)

read(2)

readlink(2)

readlinkat(2)

readv(2)

rename(2)

renameat(2)

resolvepath(2)

rmdir(2)

sbrk(2)

semctl(2)

semget(2)

semids(2)

semop(2)

semtimedop(2)

setcontext(2)

setegid(2)

seteuid(2)

setgid(2)

setgroups(2)

setitimer(2)

setpflags(2)

setpgid(2)

setpgrp(2)

setppriv(2)

setrctl(2)

setregid(2)

setreuid(2)

setrlimit(2)

setsid(2)

settaskid(2)

setuid(2)

setustack(2)

shmadv(2)

shmat(2)

shmctl(2)

shmdt(2)

shmget(2)

shmids(2)

shmop(2)

sigaction(2)

sigaltstack(2)

sigpending(2)

sigprocmask(2)

sigsend(2)

sigsendset(2)

sigsuspend(2)

sigwait(2)

__sparc_utrap_install(2)

stat(2)

statvfs(2)

stime(2)

swapctl(2)

symlink(2)

symlinkat(2)

sync(2)

sysfs(2)

sysinfo(2)

time(2)

times(2)

uadmin(2)

ulimit(2)

umask(2)

umount(2)

umount2(2)

uname(2)

unlink(2)

unlinkat(2)

ustat(2)

utime(2)

utimensat(2)

utimes(2)

uucopy(2)

vfork(2)

vforkx(2)

vhangup(2)

waitid(2)

wracct(2)

write(2)

writev(2)

yield(2)

pset_create

, pset_destroy

, pset_assign

- manage sets of processors

Synopsis

#include <sys/pset.h>intpset_create(psetid_t *newpset);

intpset_destroy(psetid_tpset);

intpset_assign(psetid_tpset,processorid_tcpu,psetid_t *opset);

Description

These functions control the creation and management of sets of processors. Processor sets allow a subset of the system's processors to be setaside for exclusive use by specified LWPs and processes. The binding of LWPsand processes to processor sets is controlled bypset_bind(2).

Thepset_create() function creates an empty processor set that contains no processors. On successful return,newpset will contain the ID of the newprocessor set.

Thepset_destroy() function destroys the processor setpset, releasing its constituent processorsand processes. Ifpset isPS_MYID, the processor set to which thecaller is bound is destroyed.

Thepset_assign() function assigns the processorcpu to the processor setpset.A processor that has been assigned to a processor set will runonly LWPs and processes that have been explicitly bound to that processor set,unless another LWP requires a resource that is only available on thatprocessor.

On successful return, ifopset is non-null,opset will contain the processorset ID of the former processor set of the processor.

Ifpset isPS_NONE,pset_assign() releases processorcpu from its current processorset.

Ifpset isPS_QUERY,pset_assign() makes no change to processor sets, butreturns the current processor set ID of processorcpu inopset.

Ifpset isPS_MYID, processorcpu is assigned to the processor setto which the caller belongs. If the caller does not belong toa processor set, processorcpu is released from its current processor set.

These functions are restricted to privileged processes, except forpset_assign() whenpsetisPS_QUERY.

Return Values

Upon successful completion, these functions return0. Otherwise,-1 is returned anderrno is set to indicate the error.

Errors

These functions will fail if:

EBUSY

The processor could not be moved to the specified processor set.

EFAULT

The location pointed to bynewpset was not writable by the user, or the location pointed to byopset was notNULL and not writable by the user.

EINVAL

The specified processor does not exist, the specified processor is not on-line, or an invalid processor set was specified.

ENOMEM

There was insufficient space forpset_create to create a new processor set.

ENOTSUP

The pools facility is active. Seepooladm(1M) andpool_set_status(3POOL) for information about enabling and disabling the pools facility.

EPERM

The {PRIV_SYS_RES_CONFIG} privilege is not asserted in the effective set of the calling process.

Attributes

Seeattributes(5) for descriptions of the following attributes:

See Also

pooladm(1M),psradm(1M),psrinfo(1M),psrset(1M),p_online(2),processor_bind(2),pset_bind(2),pset_info(2),pool_set_status(3POOL),pset_getloadavg(3C),attributes(5),privileges(5)

Notes

The processor set type ofPS_SYSTEM is no longer supported.

Processors with LWPs bound to them usingprocessor_bind(2) cannot be assigned toa new processor set. If this is attempted,pset_assign() will failand seterrno toEBUSY.