Leading underscores are ill-advised because such identifiers are reserved. Trailing underscores are merely ugly. Strip both. Our header guards commonly end in _H. Normalize the exceptions. Done with scripts/clean-header-guards.pl. Signed-off-by: Markus Armbruster <armbru@redhat.com> Message-Id: <20190315145123.28030-7-armbru@redhat.com> Reviewed-by: Philippe Mathieu-Daudé <philmd@redhat.com> [Changes to slirp/ dropped, as we're about to spin it off]
106 lines
3.1 KiB
C
106 lines
3.1 KiB
C
/*
|
|
* QEMU list authorization driver
|
|
*
|
|
* Copyright (c) 2018 Red Hat, Inc.
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, see <http://www.gnu.org/licenses/>.
|
|
*
|
|
*/
|
|
|
|
#ifndef QAUTHZ_LIST_H
|
|
#define QAUTHZ_LIST_H
|
|
|
|
#include "authz/base.h"
|
|
#include "qapi/qapi-types-authz.h"
|
|
|
|
#define TYPE_QAUTHZ_LIST "authz-list"
|
|
|
|
#define QAUTHZ_LIST_CLASS(klass) \
|
|
OBJECT_CLASS_CHECK(QAuthZListClass, (klass), \
|
|
TYPE_QAUTHZ_LIST)
|
|
#define QAUTHZ_LIST_GET_CLASS(obj) \
|
|
OBJECT_GET_CLASS(QAuthZListClass, (obj), \
|
|
TYPE_QAUTHZ_LIST)
|
|
#define QAUTHZ_LIST(obj) \
|
|
OBJECT_CHECK(QAuthZList, (obj), \
|
|
TYPE_QAUTHZ_LIST)
|
|
|
|
typedef struct QAuthZList QAuthZList;
|
|
typedef struct QAuthZListClass QAuthZListClass;
|
|
|
|
|
|
/**
|
|
* QAuthZList:
|
|
*
|
|
* This authorization driver provides a list mechanism
|
|
* for granting access by matching user names against a
|
|
* list of globs. Each match rule has an associated policy
|
|
* and a catch all policy applies if no rule matches
|
|
*
|
|
* To create an instance of this class via QMP:
|
|
*
|
|
* {
|
|
* "execute": "object-add",
|
|
* "arguments": {
|
|
* "qom-type": "authz-list",
|
|
* "id": "authz0",
|
|
* "props": {
|
|
* "rules": [
|
|
* { "match": "fred", "policy": "allow", "format": "exact" },
|
|
* { "match": "bob", "policy": "allow", "format": "exact" },
|
|
* { "match": "danb", "policy": "deny", "format": "exact" },
|
|
* { "match": "dan*", "policy": "allow", "format": "glob" }
|
|
* ],
|
|
* "policy": "deny"
|
|
* }
|
|
* }
|
|
* }
|
|
*
|
|
*/
|
|
struct QAuthZList {
|
|
QAuthZ parent_obj;
|
|
|
|
QAuthZListPolicy policy;
|
|
QAuthZListRuleList *rules;
|
|
};
|
|
|
|
|
|
struct QAuthZListClass {
|
|
QAuthZClass parent_class;
|
|
};
|
|
|
|
|
|
QAuthZList *qauthz_list_new(const char *id,
|
|
QAuthZListPolicy policy,
|
|
Error **errp);
|
|
|
|
ssize_t qauthz_list_append_rule(QAuthZList *auth,
|
|
const char *match,
|
|
QAuthZListPolicy policy,
|
|
QAuthZListFormat format,
|
|
Error **errp);
|
|
|
|
ssize_t qauthz_list_insert_rule(QAuthZList *auth,
|
|
const char *match,
|
|
QAuthZListPolicy policy,
|
|
QAuthZListFormat format,
|
|
size_t index,
|
|
Error **errp);
|
|
|
|
ssize_t qauthz_list_delete_rule(QAuthZList *auth,
|
|
const char *match);
|
|
|
|
|
|
#endif /* QAUTHZ_LIST_H */
|