LXR linux/include/drm/drm

   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
  40struct drm_device;
  41struct drm_file;
  42struct 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 */
  54typedef 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 */
  67typedef 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 */
  79enum 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_UNLOCKED:
 113         *
 114         * Whether &drm_ioctl_desc.func should be called with the DRM BKL held
 115         * or not. Enforced as the default for all modern drivers, hence there
 116         * should never be a need to set this flag.
 117         */
 118        DRM_UNLOCKED            = BIT(4),
 119        /**
 120         * @DRM_RENDER_ALLOW:
 121         *
 122         * This is used for all ioctl needed for rendering only, for drivers
 123         * which support render nodes. This should be all new render drivers,
 124         * and hence it should be always set for any ioctl with DRM_AUTH set.
 125         * Note though that read-only query ioctl might have this set, but have
 126         * not set DRM_AUTH because they do not require authentication.
 127         */
 128        DRM_RENDER_ALLOW        = BIT(5),
 129};
 130
 131/**
 132 * struct drm_ioctl_desc - DRM driver ioctl entry
 133 * @cmd: ioctl command number, without flags
 134 * @flags: a bitmask of &enum drm_ioctl_flags
 135 * @func: handler for this ioctl
 136 * @name: user-readable name for debug output
 137 *
 138 * For convenience it's easier to create these using the DRM_IOCTL_DEF_DRV()
 139 * macro.
 140 */
 141struct drm_ioctl_desc {
 142        unsigned int cmd;
 143        enum drm_ioctl_flags flags;
 144        drm_ioctl_t *func;
 145        const char *name;
 146};
 147
 148/**
 149 * DRM_IOCTL_DEF_DRV() - helper macro to fill out a &struct drm_ioctl_desc
 150 * @ioctl: ioctl command suffix
 151 * @_func: handler for the ioctl
 152 * @_flags: a bitmask of &enum drm_ioctl_flags
 153 *
 154 * Small helper macro to create a &struct drm_ioctl_desc entry. The ioctl
 155 * command number is constructed by prepending ``DRM_IOCTL\_`` and passing that
 156 * to DRM_IOCTL_NR().
 157 */
 158#define DRM_IOCTL_DEF_DRV(ioctl, _func, _flags)                         \
 159        [DRM_IOCTL_NR(DRM_IOCTL_##ioctl) - DRM_COMMAND_BASE] = {        \
 160                .cmd = DRM_IOCTL_##ioctl,                               \
 161                .func = _func,                                          \
 162                .flags = _flags,                                        \
 163                .name = #ioctl                                          \
 164        }
 165
 166int drm_ioctl_permit(u32 flags, struct drm_file *file_priv);
 167long drm_ioctl(struct file *filp, unsigned int cmd, unsigned long arg);
 168long drm_ioctl_kernel(struct file *, drm_ioctl_t, void *, u32);
 169#ifdef CONFIG_COMPAT
 170long drm_compat_ioctl(struct file *filp, unsigned int cmd, unsigned long arg);
 171#else
 172/* Let drm_compat_ioctl be assigned to .compat_ioctl unconditionally */
 173#define drm_compat_ioctl NULL
 174#endif
 175bool drm_ioctl_flags(unsigned int nr, unsigned int *flags);
 176
 177int drm_noop(struct drm_device *dev, void *data,
 178             struct drm_file *file_priv);
 179int drm_invalid_op(struct drm_device *dev, void *data,
 180                   struct drm_file *file_priv);
 181
 182#endif /* _DRM_IOCTL_H_ */
 183