init_module.2 man page ERRORS text for signed modules

init_module.2 man page ERRORS text for signed modules

[Michael Kerrisk (man-pages)]

Hi David, Rusty,

Linux 3.7 added signed modules. As a consequence, init_module()
acquired some new possible error returns. I've put together the text
below to describe the new errors. Does the text look okay?

Thanks,

Michael

.TP
.BR EBADMSG " (since Linux 3.7)"
Module signature is misformatted.
.TP
.BR ENOKEY " (since Linux 3.7)"
.\" commit 48ba2462ace6072741fd8d0058207d630ce93bf1
.\" commit 1d0059f3a468825b5fc5405c636a2f6e02707ffa
.\" commit 106a4ee258d14818467829bf0e12aeae14c16cd7
Module signature is invalid or module is unsigned.
This error is returned only if the kernel was configured with
.BR CONFIG_MODULE_SIG_FORCE ;
if the kernel was not configured with this option,
then an invalid or usigned module simply taints the kernel.

Re: init_module.2 man page ERRORS text for signed modules

[Michael Kerrisk (man-pages)]

[Just after sending, I noticed an error in the text for those errors.
I've amended and am resending]

Hi David, Rusty,

Linux 3.7 added signed modules. As a consequence, init_module()
acquired some new possible error returns. I've put together the text
below to describe the new errors. Does the text look okay?

Thanks,

Michael

.TP
.BR EBADMSG " (since Linux 3.7)"
Module signature is misformatted.
.TP
.BR ENOKEY " (since Linux 3.7)"
.\" commit 48ba2462ace6072741fd8d0058207d630ce93bf1
.\" commit 1d0059f3a468825b5fc5405c636a2f6e02707ffa
.\" commit 106a4ee258d14818467829bf0e12aeae14c16cd7
Module signature is invalid or the kernel does not have a key for this module.
This error is returned only if the kernel was configured with
.BR CONFIG_MODULE_SIG_FORCE ;
if the kernel was not configured with this option,
then an invalid or usigned module simply taints the kernel.

Re: init_module.2 man page ERRORS text for signed modules

[Rusty Russell]

"Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com> writes:

> Hi David, Rusty,
>
> Linux 3.7 added signed modules. As a consequence, init_module()
> acquired some new possible error returns. I've put together the text
> below to describe the new errors. Does the text look okay?

Looks good.  I liked the finit_module text, too.

Thanks!
Rusty.

Re: init_module.2 man page ERRORS text for signed modules

[Michael Kerrisk (man-pages)]

Hi Rusty,

On Mon, Jan 7, 2013 at 2:14 AM, Rusty Russell <rusty@rustcorp.com.au> wrote:
> "Michael Kerrisk (man-pages)" <mtk.manpages@gmail.com> writes:
>
>> Hi David, Rusty,
>>
>> Linux 3.7 added signed modules. As a consequence, init_module()
>> acquired some new possible error returns. I've put together the text
>> below to describe the new errors. Does the text look okay?
>
> Looks good.  I liked the finit_module text, too.

Okay -- thanks for checking the text!

Cheers,

Michael

PS See you in Canberra!


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/