~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

TOMOYO Linux Cross Reference
Linux/include/drm/drm_ioctl.h

Version: ~ [ linux-4.16-rc2 ] ~ [ linux-4.15.4 ] ~ [ linux-4.14.20 ] ~ [ linux-4.13.16 ] ~ [ linux-4.12.14 ] ~ [ linux-4.11.12 ] ~ [ linux-4.10.17 ] ~ [ linux-4.9.82 ] ~ [ linux-4.8.17 ] ~ [ linux-4.7.10 ] ~ [ linux-4.6.7 ] ~ [ linux-4.5.7 ] ~ [ linux-4.4.116 ] ~ [ linux-4.3.6 ] ~ [ linux-4.2.8 ] ~ [ linux-4.1.49 ] ~ [ linux-4.0.9 ] ~ [ linux-3.19.8 ] ~ [ linux-3.18.95 ] ~ [ linux-3.17.8 ] ~ [ linux-3.16.54 ] ~ [ linux-3.15.10 ] ~ [ linux-3.14.79 ] ~ [ linux-3.13.11 ] ~ [ linux-3.12.74 ] ~ [ linux-3.11.10 ] ~ [ linux-3.10.108 ] ~ [ linux-3.9.11 ] ~ [ linux-3.8.13 ] ~ [ linux-3.7.10 ] ~ [ linux-3.6.11 ] ~ [ linux-3.5.7 ] ~ [ linux-3.4.113 ] ~ [ linux-3.3.8 ] ~ [ linux-3.2.99 ] ~ [ linux-3.1.10 ] ~ [ linux-3.0.101 ] ~ [ linux-2.6.39.4 ] ~ [ linux-2.6.38.8 ] ~ [ linux-2.6.37.6 ] ~ [ linux-2.6.36.4 ] ~ [ linux-2.6.35.14 ] ~ [ linux-2.6.34.15 ] ~ [ linux-2.6.33.20 ] ~ [ linux-2.6.32.71 ] ~ [ linux-2.6.27.62 ] ~ [ linux-2.6.0 ] ~ [ linux-2.4.37.11 ] ~ [ unix-v6-master ] ~ [ ccs-tools-1.8.5 ] ~ [ policy-sample ] ~
Architecture: ~ [ i386 ] ~ [ alpha ] ~ [ m68k ] ~ [ mips ] ~ [ ppc ] ~ [ sparc ] ~ [ sparc64 ] ~

  1 /*
  2  * Internal Header for the Direct Rendering Manager
  3  *
  4  * Copyright 1999 Precision Insight, Inc., Cedar Park, Texas.
  5  * Copyright 2000 VA Linux Systems, Inc., Sunnyvale, California.
  6  * Copyright (c) 2009-2010, Code Aurora Forum.
  7  * All rights reserved.
  8  *
  9  * Author: Rickard E. (Rik) Faith <faith@valinux.com>
 10  * Author: Gareth Hughes <gareth@valinux.com>
 11  *
 12  * Permission is hereby granted, free of charge, to any person obtaining a
 13  * copy of this software and associated documentation files (the "Software"),
 14  * to deal in the Software without restriction, including without limitation
 15  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 16  * and/or sell copies of the Software, and to permit persons to whom the
 17  * Software is furnished to do so, subject to the following conditions:
 18  *
 19  * The above copyright notice and this permission notice (including the next
 20  * paragraph) shall be included in all copies or substantial portions of the
 21  * Software.
 22  *
 23  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 24  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 25  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 26  * VA LINUX SYSTEMS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
 27  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 28  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 29  * OTHER DEALINGS IN THE SOFTWARE.
 30  */
 31 
 32 #ifndef _DRM_IOCTL_H_
 33 #define _DRM_IOCTL_H_
 34 
 35 #include <linux/types.h>
 36 #include <linux/bitops.h>
 37 
 38 #include <asm/ioctl.h>
 39 
 40 struct drm_device;
 41 struct drm_file;
 42 struct file;
 43 
 44 /**
 45  * drm_ioctl_t - DRM ioctl function type.
 46  * @dev: DRM device inode
 47  * @data: private pointer of the ioctl call
 48  * @file_priv: DRM file this ioctl was made on
 49  *
 50  * This is the DRM ioctl typedef. Note that drm_ioctl() has alrady copied @data
 51  * into kernel-space, and will also copy it back, depending upon the read/write
 52  * settings in the ioctl command code.
 53  */
 54 typedef int drm_ioctl_t(struct drm_device *dev, void *data,
 55                         struct drm_file *file_priv);
 56 
 57 /**
 58  * drm_ioctl_compat_t - compatibility DRM ioctl function type.
 59  * @filp: file pointer
 60  * @cmd: ioctl command code
 61  * @arg: DRM file this ioctl was made on
 62  *
 63  * Just a typedef to make declaring an array of compatibility handlers easier.
 64  * New drivers shouldn't screw up the structure layout for their ioctl
 65  * structures and hence never need this.
 66  */
 67 typedef int drm_ioctl_compat_t(struct file *filp, unsigned int cmd,
 68                                unsigned long arg);
 69 
 70 #define DRM_IOCTL_NR(n)                _IOC_NR(n)
 71 #define DRM_MAJOR       226
 72 
 73 /**
 74  * enum drm_ioctl_flags - DRM ioctl flags
 75  *
 76  * Various flags that can be set in &drm_ioctl_desc.flags to control how
 77  * userspace can use a given ioctl.
 78  */
 79 enum drm_ioctl_flags {
 80         /**
 81          * @DRM_AUTH:
 82          *
 83          * This is for ioctl which are used for rendering, and require that the
 84          * file descriptor is either for a render node, or if it's a
 85          * legacy/primary node, then it must be authenticated.
 86          */
 87         DRM_AUTH                = BIT(0),
 88         /**
 89          * @DRM_MASTER:
 90          *
 91          * This must be set for any ioctl which can change the modeset or
 92          * display state. Userspace must call the ioctl through a primary node,
 93          * while it is the active master.
 94          *
 95          * Note that read-only modeset ioctl can also be called by
 96          * unauthenticated clients, or when a master is not the currently active
 97          * one.
 98          */
 99         DRM_MASTER              = BIT(1),
100         /**
101          * @DRM_ROOT_ONLY:
102          *
103          * Anything that could potentially wreak a master file descriptor needs
104          * to have this flag set. Current that's only for the SETMASTER and
105          * DROPMASTER ioctl, which e.g. logind can call to force a non-behaving
106          * master (display compositor) into compliance.
107          *
108          * This is equivalent to callers with the SYSADMIN capability.
109          */
110         DRM_ROOT_ONLY           = BIT(2),
111         /**
112          * @DRM_CONTROL_ALLOW:
113          *
114          * Deprecated, do not use. Control nodes are in the process of getting
115          * removed.
116          */
117         DRM_CONTROL_ALLOW       = BIT(3),
118         /**
119          * @DRM_UNLOCKED:
120          *
121          * Whether &drm_ioctl_desc.func should be called with the DRM BKL held
122          * or not. Enforced as the default for all modern drivers, hence there
123          * should never be a need to set this flag.
124          */
125         DRM_UNLOCKED            = BIT(4),
126         /**
127          * @DRM_RENDER_ALLOW:
128          *
129          * This is used for all ioctl needed for rendering only, for drivers
130          * which support render nodes. This should be all new render drivers,
131          * and hence it should be always set for any ioctl with DRM_AUTH set.
132          * Note though that read-only query ioctl might have this set, but have
133          * not set DRM_AUTH because they do not require authentication.
134          */
135         DRM_RENDER_ALLOW        = BIT(5),
136 };
137 
138 /**
139  * struct drm_ioctl_desc - DRM driver ioctl entry
140  * @cmd: ioctl command number, without flags
141  * @flags: a bitmask of &enum drm_ioctl_flags
142  * @func: handler for this ioctl
143  * @name: user-readable name for debug output
144  *
145  * For convenience it's easier to create these using the DRM_IOCTL_DEF_DRV()
146  * macro.
147  */
148 struct drm_ioctl_desc {
149         unsigned int cmd;
150         enum drm_ioctl_flags flags;
151         drm_ioctl_t *func;
152         const char *name;
153 };
154 
155 /**
156  * DRM_IOCTL_DEF_DRV() - helper macro to fill out a &struct drm_ioctl_desc
157  * @ioctl: ioctl command suffix
158  * @_func: handler for the ioctl
159  * @_flags: a bitmask of &enum drm_ioctl_flags
160  *
161  * Small helper macro to create a &struct drm_ioctl_desc entry. The ioctl
162  * command number is constructed by prepending ``DRM_IOCTL\_`` and passing that
163  * to DRM_IOCTL_NR().
164  */
165 #define DRM_IOCTL_DEF_DRV(ioctl, _func, _flags)                         \
166         [DRM_IOCTL_NR(DRM_IOCTL_##ioctl) - DRM_COMMAND_BASE] = {        \
167                 .cmd = DRM_IOCTL_##ioctl,                               \
168                 .func = _func,                                          \
169                 .flags = _flags,                                        \
170                 .name = #ioctl                                          \
171         }
172 
173 int drm_ioctl_permit(u32 flags, struct drm_file *file_priv);
174 long drm_ioctl(struct file *filp, unsigned int cmd, unsigned long arg);
175 long drm_ioctl_kernel(struct file *, drm_ioctl_t, void *, u32);
176 #ifdef CONFIG_COMPAT
177 long drm_compat_ioctl(struct file *filp, unsigned int cmd, unsigned long arg);
178 #else
179 /* Let drm_compat_ioctl be assigned to .compat_ioctl unconditionally */
180 #define drm_compat_ioctl NULL
181 #endif
182 bool drm_ioctl_flags(unsigned int nr, unsigned int *flags);
183 
184 int drm_noop(struct drm_device *dev, void *data,
185              struct drm_file *file_priv);
186 int drm_invalid_op(struct drm_device *dev, void *data,
187                    struct drm_file *file_priv);
188 
189 #endif /* _DRM_IOCTL_H_ */
190 

~ [ source navigation ] ~ [ diff markup ] ~ [ identifier search ] ~

kernel.org | git.kernel.org | LWN.net | Project Home | Wiki (Japanese) | Wiki (English) | SVN repository | Mail admin

Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.

osdn.jp