mirror of
				https://github.com/qemu/qemu.git
				synced 2025-10-31 12:07:31 +00:00 
			
		
		
		
	 a8b991b52d
			
		
	
	
		a8b991b52d
		
	
	
	
	
		
			
			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 */
 |