/usr/include/webauth/keys.h is in libwebauth-dev 4.0.2-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 | /*
* WebAuth key and keyring manipulation functions.
*
* These interfaces handle WebAuth keys and keyrings. A key is used for token
* encryption and decryption. A keyring is a collection of keys with various
* use-by dates to allow key rollover while decrypting tokens encrypted with
* older keys.
*
* Written by Russ Allbery <rra@stanford.edu>
* Copyright 2011
* The Board of Trustees of the Leland Stanford Junior University
*
* Permission is hereby granted, free of charge, to any person obtaining a
* copy of this software and associated documentation files (the "Software"),
* to deal in the Software without restriction, including without limitation
* the rights to use, copy, modify, merge, publish, distribute, sublicense,
* and/or sell copies of the Software, and to permit persons to whom the
* Software is furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
* THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
* DEALINGS IN THE SOFTWARE.
*/
#ifndef WEBAUTH_KEYS_H
#define WEBAUTH_KEYS_H 1
#include <webauth/defines.h>
/* FIXME: Most key functions have not yet been migrated to APR. */
#include <webauth.h>
BEGIN_DECLS
/*
* Given a key, form a single-element keyring around it. Used to convert keys
* to keyrings for functions that want a keyring. Stores the new keyring in
* the ring argument and returns a WebAuth error code. The key will currently
* be copied into the ring. On failure, ring will be set to NULL.
*/
int webauth_keyring_from_key(struct webauth_context *, const WEBAUTH_KEY *,
WEBAUTH_KEYRING **)
__attribute__((__nonnull__));
END_DECLS
#endif /* !WEBAUTH_KEYS_H */
|