← Back to branch summary

~ubuntu-branches/ubuntu/saucy/manpages/saucy

« back to all changes in this revision

Viewing changes to man2/request_key.2

  • Committer: Bazaar Package Importer
  • Author(s): Loïc Minier
  • Date: 2010-11-11 16:51:09 UTC
  • mfrom: (1.1.44 upstream) (2.2.7 sid)
  • Revision ID: james.westby@ubuntu.com-20101111165109-3yiyen1axa1ju3s0
Tags: 3.26-1ubuntu1
* Merge from Debian unstable; remaining changes:
  - ptrace.2, prctl.2: document Ubuntu-specific PTRACE_ATTACH,
    PR_SET_PTRACER behavior.

Show diffs side-by-side

added added

removed removed

Lines of Context:
man2/request_key.2
8
8
.\" 2 of the License, or (at your option) any later version.
9
9
.\"
10
10
.TH REQUEST_KEY 2 2010-02-25 Linux "Linux Key Management Calls"
11
 
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
12
11
.SH NAME
13
12
request_key \- Request a key from the kernel's key management facility
14
 
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
15
13
.SH SYNOPSIS
16
14
.nf
17
15
.B #include <keyutils.h>
18
16
.sp
19
17
.BI "key_serial_t request_key(const char *" type ", const char *" description ,
20
18
.BI "const char *" callout_info ", key_serial_t " keyring ");"
21
 
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
22
19
.SH DESCRIPTION
23
20
.BR request_key ()
24
21
asks the kernel to find a key of the given
89
86
will displace any other key of the same type and description from the
90
87
destination
91
88
.IR keyring .
92
 
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
93
89
.SH RETURN VALUE
94
90
On success
95
91
.BR request_key ()
97
93
On error, the value
98
94
.B -1
99
95
will be returned and errno will have been set to an appropriate error.
100
 
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
101
96
.SH ERRORS
102
97
.TP
103
98
.B ENOKEY
124
119
.TP
125
120
.B EACCES
126
121
The keyring wasn't available for modification by the user.
127
 
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
128
122
.SH LINKING
129
123
Although this is a Linux system call, it is not present in
130
124
.I libc
133
127
When linking,
134
128
.B -lkeyutils
135
129
should be specified to the linker.
136
 
.\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
137
130
.SH SEE ALSO
138
131
.BR keyctl (1),
139
132
.BR add_key (2),
140
133
.BR keyctl (2),
141
134
.BR request-key (8)
142
135
.SH COLOPHON
143
 
This page is part of release 3.25 of the Linux
 
136
This page is part of release 3.26 of the Linux
144
137
.I man-pages
145
138
project.
146
139
A description of the project,