rt_tgsigqueueinfo man page

rt_tgsigqueueinfo man page

[Stephan Mueller]

[-- Attachment #1: Type: Text/Plain, Size: 225 bytes --]

Hi,

please see attached file for the rt_tgsigqueueinfo man page.

This man page was derived from the discussion in 
http://help.lockergnome.com/linux/patch-add-rt_tgsigqueueinfo-syscall-V2--
ftopict495666.html

Ciao
Stephan

[-- Attachment #2: rt_tgsigqueueinfo.2 --]
[-- Type: text/plain, Size: 1105 bytes --]

.TH RECVMMSG 2 2011-02-09 "Linux" "Linux Programmer's Manual"
.SH NAME
rt_tgsigqueueinfo \- Send signal information to a signal to a thread
.SH SYNOPSIS
.nf
.BI "long sys_rt_tgsigqueueinfo (int " tgid ", int " tid ", int " sig ,
.BI "                            siginfo_t *" uinfo );
.fi
.SH DESCRIPTION
.BR rt_tgsigqueueinfo ()
sends the signal
.I sig
with the information
.I uinfo
to the thread with the thread ID
.I tid
in the thread group
.IR tgid.
By contrast,
.BR rt_sigqueueinfo(2)
can only be used to send a signal info to a process (i.e., thread group)
s a whole, and the signal will be delivered to an arbitrary thread within that
process.
.SH RETURN VALUE
.BR rt_tgsigqueueinfo ()
returns 0 on success.
On error, \-1 is returned, and \fIerrno\fP is set appropriately.
.SH ERRORS
.B EFAULT
An invalid value for
.I uinfo
was specified.
.TP
.B EINVAL
An invalid
.IR tid,
.I TGID
or
.I sig
was specified.
.TP
.B EPERM
Permission denied. For the required permissions,
see
.BR rt_sigqueueinfo(2) .
.B ESRCH
No process with the specified
.I tid
and
.I tgid
exists. 
.SH SEE ALSO
.B rt_sigqueueinfo(2)

Re: rt_tgsigqueueinfo man page

[Michael Kerrisk]

Hi Stephan,

On Wed, Feb 9, 2011 at 2:52 PM, Stephan Mueller
<stephan.mueller-fwYZOkdEjagAvxtiuMwx3w@public.gmane.org> wrote:
> Hi,
>
> please see attached file for the rt_tgsigqueueinfo man page.
>
> This man page was derived from the discussion in
> http://help.lockergnome.com/linux/patch-add-rt_tgsigqueueinfo-syscall-V2--
> ftopict495666.html

Thanks for that. It was long on my TODO list to write some proper
documentation for this system call. But what is really needed is a
page that combines rt_sigqueueinfo() (which was incompletely
documented in the "sigqueue.2" page) and rt_tgsigqueueinfo(). I've
done that now. See my other mail on the topic.

Best regards,

Michael


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html