asahi: Add allocation data structure

Something half-way between what IOKit (macOS) and DRM (Linux) want.

Signed-off-by: Alyssa Rosenzweig <alyssa@rosenzweig.io>
Acked-by: Jason Ekstrand <jason@jlekstrand.net>
Acked-by: Bas Nieuwenhuizen <bas@basnieuwenhuizen.nl>
Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/10582>

src/asahi/lib/agx_allocation.h

@@ -0,0 +1,100 @@
+/*
+ * Copyright (C) 2021 Alyssa Rosenzweig <alyssa@rosenzweig.io>
+ * © Copyright 2019 Collabora, Ltd.
+ *
+ * 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 (including the next
+ * paragraph) 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 __AGX_BO_H
+#define __AGX_BO_H
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+
+struct agx_device;
+
+enum agx_alloc_type {
+   AGX_ALLOC_REGULAR = 0,
+   AGX_ALLOC_MEMMAP = 1,
+   AGX_ALLOC_CMDBUF = 2,
+   AGX_NUM_ALLOC,
+};
+
+struct agx_ptr {
+   /* If CPU mapped, CPU address. NULL if not mapped */
+   void *cpu;
+
+   /* If type REGULAR, mapped GPU address */
+   uint64_t gpu;
+};
+
+enum agx_bo_access {
+   AGX_BO_ACCESS_NONE = 0,
+   AGX_BO_ACCESS_R = 1,
+   AGX_BO_ACCESS_W = 2,
+   AGX_BO_ACCESS_RW = 3
+};
+
+struct agx_bo {
+   enum agx_alloc_type type;
+
+   /* Creation attributes */
+   unsigned flags;
+   size_t size;
+
+   /* Mapping */
+   struct agx_ptr ptr;
+
+   /* Index unique only up to type, process-local */
+   uint32_t handle;
+
+   /* Globally unique value (system wide) for tracing. Exists for resources,
+    * command buffers, GPU submissions, segments, segmentent lists, encoders,
+    * accelerators, and channels. Corresponds to Instruments' magic table
+    * metal-gpu-submission-to-command-buffer-id */
+   uint64_t guid;
+
+   /* Outstanding access for bo_wait */
+   enum agx_bo_access access;
+
+   /* Human-readable label, or NULL if none */
+   char *name;
+
+   /* Owner */
+   struct agx_device *dev;
+
+   /* Update atomically */
+   int32_t refcnt;
+
+   /* Used while decoding, marked read-only */
+   bool ro;
+
+   /* Used while decoding, mapped */
+   bool mapped;
+};
+
+struct agx_bo *
+agx_bo_create(struct agx_device *dev, unsigned size, unsigned flags);
+
+void agx_bo_reference(struct agx_bo *bo);
+void agx_bo_unreference(struct agx_bo *bo);
+
+#endif