<html><head><meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title></title><style type="text/css">
<!--
.style1 {font-size: 18px;font-weight: bold;font-family: Georgia, "Times New Roman", Times, serif;}
a{color:#0000cc;text-decoration:none}
a:visited{color:#0000cc;text-decoration:none}
-->
</style></head>
<body style="margin:0px 0px 0px 0px;">
<table width="100%" border="0" cellpadding="0" cellspacing="0">
<tr>
<td bgcolor="#cccccc"><span class="style1" style="margin-left:5px">KEYCTL_REVOKE</span></td>
</tr>
<tr>
<td><p style="margin-left:22px;margin-top:0px"><br />
Marks a key as being revoked. After this operation has been performed on a key, attempts to access it will meet with error <strong>-</strong>EKEYREVOKED. </p>
<p style="margin-left:10px"><strong>Arguments</strong></p>
<table width="100%" border="0" style="margin-left:20px; margin-right:20px">
<tr>
<td width="6%" valign="top"><em>ecx</em></td>
<td width="94%">Key serial number. It may be one of the following special values:<br />
<br />
<table width="100%" border="0" style="border:dashed;border-bottom-width:1px;border-left-width:1px;border-right-width:1px;border-top-width:1px;border-color:#333333">
<tr>
<td> <table width="100%" border="0">
<tr>
<td width="29%" valign="top"><code>KEY_SPEC_THREAD_KEYRING</code></td>
<td width="71%"><code>Caller's thread-specific keyring. </code></td>
</tr>
<tr>
<td valign="top"><code>KEY_SPEC_PROCESS_KEYRING</code></td>
<td><code>Caller's process-specific keyring. </code></td>
</tr>
<tr>
<td valign="top"><code>KEY_SPEC_SESSION_KEYRING</code></td>
<td><code>Caller's session-specific keyring. </code></td>
</tr>
<tr>
<td valign="top"><code>KEY_SPEC_USER_KEYRING</code></td>
<td><code>Caller's UID-specific keyring. </code></td>
</tr>
<tr>
<td valign="top"><code>KEY_SPEC_USER_SESSION_KEYRING</code></td>
<td><code>Caller's UID-session keyring. </code></td>
</tr>
<tr>
<td valign="top"><code>KEY_SPEC_GROUP_KEYRING</code></td>
<td><code>Caller's GID-specific keyring.</code></td>
</tr>
<tr>
<td valign="top"><code>KEY_SPEC_REQKEY_AUTH_KEY</code></td>
<td><code>This specifies the authorization key created by request_key() and passed to the process it spawns to generate a key. If a valid keyring ID is passed in, then this will simply be returned if the key exists; an error will be issued if it doesn't exist.</code></td>
</tr>
</table> </td>
</tr>
</table></td>
</tr>
</table>
<p style="margin-left:10px" ><strong>Return values</strong></p>
<p style="margin-left:22px;margin-right:10px" >If the system call succeeds the return value is 0.<br />
If the system call fails the return value is one of the following <em>errno</em> values:</p>
<table width="100%" border="0" style="border:dashed;border-bottom-width:1px;border-left-width:1px;border-right-width:1px;border-top-width:1px;border-color:#333333;margin-left:22px;margin-right:22px">
<tr>
<td><table width="100%" border="0">
<tr>
<td width="9%" valign="top"><code>-ENOKEY </code></td>
<td width="91%" valign="top"><code>No matching key was found. </code></td>
</tr>
<tr>
<td valign="top"><code>-EKEYREVOKED </code></td>
<td valign="top"><code>The key has already been revoked. </code></td>
</tr>
<tr>
<td valign="top"><code>-EACCES </code></td>
<td valign="top"><code>The named key exists, but is not writable by the calling process.</code></td>
</tr>
</table></td>
</tr>
</table>
<p style="margin-left:10px"><strong>Remarks</strong></p>
<p style="margin-left:22px">The caller must have write permission on a key to be able revoke it. </p>
</td>
</tr>
</table></body></html>