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_info(2)

profil(2)

pset_assign(2)

pset_bind(2)

pset_create(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)

processor_bind

- bind LWPs to a processor

Synopsis

#include <sys/types.h>#include <sys/processor.h>#include <sys/procset.h>intprocessor_bind(idtype_tidtype,id_tid,processorid_tprocessorid,processorid_t *obind);

Description

Theprocessor_bind() function binds the LWP (lightweight process) or set of LWPsspecified byidtype andid to the processor specified byprocessorid.Ifobind is notNULL, this function also sets theprocessorid_t variablepointed to byobind to the previous binding of one of thespecified LWPs, or toPBIND_NONE if the selected LWP was not bound.

Ifidtype isP_PID, the binding affects all LWPs of the processwith process ID (PID)id.

Ifidtype isP_LWPID, the binding affects the LWP of the currentprocess with LWP IDid.

Ifidtype isP_TASKID, the binding affects all LWPs of all processeswith task IDid.

Ifidtype isP_PROJID, the binding affects all LWPs of all processeswith project IDid.

Ifidtype isP_CTID, the binding affects all LWPs of all processeswith process contract IDid.

Ifidtype isP_ZONEID, the binding affects all LWPs of all processeswith zone IDid.

Ifid isP_MYID, the specified LWP, process, task, or project isthe current one.

Ifprocessorid isPBIND_NONE, the processor bindings of the specified LWPs arecleared.

Ifprocessorid isPBIND_QUERY, the processor bindings are not changed.

The {PRIV_PROC_OWNER} privilege must be asserted in the effective set of thecalling process or the real or effective user ID of the callingprocess must match the real or effective user ID of the LWPsbeing bound. If the calling process does not have permission to changeall of the specified LWPs, the bindings of the LWPs for whichit does have permission will be changed even though an error isreturned.

Processor bindings are inherited acrossfork(2) andexec(2).

Return Values

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

Errors

Theprocessor_bind() function will fail if:

EFAULT

The location pointed to byobind was notNULL and not writable by the user.

EINVAL

The specified processor is not on-line, or theidtype argument was notP_PID,P_LWPID,P_PROJID,P_TASKID,P_CTID, orP_ZONEID.

The caller is in a non-global zone, the pools facility is active, and the processor is not a member of the zone's pool's processor set.

ENOTSUP

Binding a system process to a processor set is not supported.

EPERM

The {PRIV_PROC_OWNER} privilege is not asserted in the effective set of the calling process and its real or effective user ID does not match the real or effective user ID of one of the LWPs being bound.

ESRCH

No processes, LWPs, or tasks were found to match the criteria specified byidtype andid.

Attributes

Seeattributes(5) for descriptions of the following attributes:

See Also

pooladm(1M),psradm(1M),psrinfo(1M),zoneadm(1M),exec(2),fork(2),p_online(2),pset_bind(2),sysconf(3C),process(4),project(4),attributes(5),privileges(5)