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)

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_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)

kill

- send a signal to a process or a group of processes

Synopsis

#include <sys/types.h>#include <signal.h>intkill(pid_tpid,intsig);

Description

Thekill() function sends a signal to a process or a groupof processes. The process or group of processes to which the signalis to be sent is specified bypid. The signal that isto be sent is specified bysig and is either one from thelist given insignal (seesignal.h(3HEAD)), or 0. Ifsig is 0 (thenull signal), error checking is performed but no signal is actually sent.This can be used to check the validity ofpid.

The real or effective user ID of the sending process must matchthe real or saved (from one of functions in theexec(2) family)user ID of the receiving process, unless the privilege {PRIV_PROC_OWNER} is assertedin the effective set of the sending process (seeIntro(2)), orsigisSIGCONT and the sending process has the same session ID as thereceiving process. A process needs the basic privilege {PRIV_PROC_SESSION} to send signalsto a process with a different session ID. Seeprivileges(5).

Ifpid is greater than 0,sig will be sent to theprocess whose process ID is equal topid.

Ifpid is negative but not(pid_t)-1,sig will be sent toall processes whose process group ID is equal to the absolute valueofpid and for which the process has permission to send asignal.

Ifpid is 0,sig will be sent to all processes excludingspecial processes (seeIntro(2)) whose process group ID is equal to theprocess group ID of the sender.

Ifpid is(pid_t)-1 and the {PRIV_PROC_OWNER} privilege is not asserted inthe effective set of the sending process,sig will be sent toall processes excluding special processes whose real user ID is equal to theeffective user ID of the sender.

Ifpid is(pid_t)-1 and the {PRIV_PROC_OWNER} privilege is asserted in theeffective set of the sending process,sig will be sent to allprocesses excluding special processes.

Return Values

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

Errors

Thekill() function will fail if:

EINVAL

Thesig argument is not a valid signal number.

EPERM

Thesig argument isSIGKILL and thepid argument is(pid_t)-1 (that is, the calling process does not have permission to send the signal to any of the processes specified bypid).

The effective user of the calling process does not match the real or saved user and the calling process does not have the {PRIV_PROC_OWNER} privilege asserted in the effective set, and the calling process either is not sendingSIGCONT to a process that shares the same session ID or does not have the {PRIV_PROC_SESSION} privilege asserted and is trying to send a signal to a process with a different session ID.

ESRCH

No process or process group can be found corresponding to that specified bypid.

Usage

Thesigsend(2) function provides a more versatile way to send signals toprocesses.

Attributes

Seeattributes(5) for descriptions of the following attributes:

See Also

kill(1),Intro(2),exec(2),getpid(2),getsid(2),setpgrp(2),sigaction(2),sigsend(2),signal(3C),signal.h(3HEAD),attributes(5),privileges(5),standards(5)