From nobody Fri Dec 19 16:01:36 2025 Received: from mail-qt1-f181.google.com (mail-qt1-f181.google.com [209.85.160.181]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 781641A9B4C; Fri, 23 May 2025 19:52:34 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.160.181 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748029956; cv=none; b=TPiViG7bdyZi3o3dAjWE/8UZVPotoyX6xZGyiDkmivxWgoE2HowTTMYSkEWYcc+tUKSctoyNTaE2sXbQVnBcaxazj+MWyC1T43vJWEQDojuGg7JooqwxJKYHzJcceV1bDuyUYG0UhMdR88lGC3VCErCX5g4/Vz8k7V1SudqLZ/Y= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748029956; c=relaxed/simple; bh=B7ivfgJeKG6ORpMwQ6TTvaIfeyjPMtOvKMOcVgmHwy4=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=IX3yIv0afbBZqEDaJOshtqH4AGHqvT3ahWrWV+6ow09HFpctSaYq8zYG4SbNhIa6ScUBYZBLPSRxR6I2Kf8EGcIVaJkM+KCcjlxAD9LVzk2Z227nnLHqkER4xQA3NxhZq338ufd3acH6H9xI/Enre7ZcBnWUZ8IP4GoNfNCEZgE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=l0XBzMPV; arc=none smtp.client-ip=209.85.160.181 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="l0XBzMPV" Received: by mail-qt1-f181.google.com with SMTP id d75a77b69052e-4769f3e19a9so1537591cf.0; Fri, 23 May 2025 12:52:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1748029953; x=1748634753; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=nrabLxj8R0+gWSgXlOCfum1YIagrx7v3OcNYJ2wlWMQ=; b=l0XBzMPVftKxiuMRhwCfNHjnoF2H0SGB0p2OibDcl1pp4NaKkAfTt9RnWLPwqBJLXJ biV1rGvlv2IWzReTOfEaBFzoa+y8Wg0gW1FGNPKeIHplrCgg22j4nAppvv6Q3vz5WB4x gTAB03ht9tu726Clwblh3nCADNAUcmQlRu2TJLkhDUsd3YRN0dt8Vox6z8fInjodjg3a B0SYxL4JCGzTrAeyKi1WDMRKeHoyJWz6k/9BqdXPn9IUfpoqzBp2KgbQh5byizwubWDs GQKHxsuR/yWXWivh0AKJdXU2BBUXlbaW0NJTjUnAWMtWY/SUmmvBZeutorHoip5tNUSg uuxg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1748029953; x=1748634753; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=nrabLxj8R0+gWSgXlOCfum1YIagrx7v3OcNYJ2wlWMQ=; b=D6XBDU4nHYER2FtER28e/Gx1PeXnoC0Mu9p6ldwTjlbTcn1O/dFwnFm2lfqUDMbOY0 3d/7tnXgnTUeX2nYeIxtYmKubibaFU2pkWUI28dXkt6Y9BEl+M1XqCdWlxro16Rw5LjQ qlM/sIkALgdw1/w3a5KtPF7Ba9BVfYQP2JW+Ysm8gmu3MmMq3oUyVd1IMUfGgBU6M7UY n3CcG6fdWF+/DGuUYF78jFW8CTXM4rXJc7s0OxQOhdndR0Z6Hls2thtJH0IuA5z5mf/e ICdYubZH93NGcvGlZqB7Wz2V9AfZKlIXOGweGWNg5sz5E9OT/IpNQaaUWw510ug9wzVO lz0w== X-Forwarded-Encrypted: i=1; AJvYcCU0Mq3fGYakUkOb7omj9rZwSV+OzrbeoigJgxlv3ILi0Bb872caj0B5hDKxJIt5NAjfqeD6PJgK+fBGjfw4@vger.kernel.org, AJvYcCVr2qN2gPd5wr1GuKZMq1QDmgUDMjugDgSuXTlOdHMjxkDtDH5lGOeAAqnuDKXpEHACfr54JY/SdxQ=@vger.kernel.org X-Gm-Message-State: AOJu0YxJH3QNler7NSiyWghQPN8WdHAv9hLRWahseaq/pX9VNlYT80n1 Z92dV4PdDjfQJxK/+CinyOXkNZKYt4TXx1siuYJ9p3F7MzFQXaUO7nGM X-Gm-Gg: ASbGncvQysiCjTrcpaXCIosyR3amAfqA4IwTDFB/DpfoalVjaJYBbbv7SC9NVmU3BzB fBQ2qW7UMWpupgTOtpWRUMCIm8xstZPzfWbAoU1xOTzN6RQk7vJkRbTrJP3N71Mt32iH/C4nPKb 8sRbvinRu4tRYy+m1Al9tg5Zrrv27I/rmTjYmwyFnnRcWLNA4FEjrqwH8fda8WxFwv6kG32VtEG FGKaXPRQVg89zPRvePTndNOY4tal7mR5ljizAYQZ73DaUWDINi2eghAeF5+GbNYAyHGNQxm90PF dwCVnVKdkLz7rjbF5rqob4vWDXntMY+bnbTSSSo0Wgb6SHg5YkhUziBZBg1r1XxSLQ== X-Google-Smtp-Source: AGHT+IHH0XRRoych4f6+KUaQ0fb+Mv8leaDYEmMTiTyLzMWDwUNEVCbrlUB98Jt4Nl8dDJzI/MYlnw== X-Received: by 2002:a05:622a:1e0c:b0:48a:c90f:ce6f with SMTP id d75a77b69052e-49f46250cdamr9680311cf.4.1748029953273; Fri, 23 May 2025 12:52:33 -0700 (PDT) Received: from [10.0.0.88] ([2607:fea8:bad7:5400:a4e6:39bc:5bd6:cf8f]) by smtp.gmail.com with ESMTPSA id d75a77b69052e-494ae4fd718sm117133001cf.53.2025.05.23.12.52.32 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 23 May 2025 12:52:32 -0700 (PDT) From: Abdulrasaq Lawani Date: Fri, 23 May 2025 15:52:25 -0400 Subject: [PATCH v2 1/2] drm: add overview diagram for drm stack Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250523-drm-doc-updates-v2-1-e517df152cf6@gmail.com> References: <20250523-drm-doc-updates-v2-0-e517df152cf6@gmail.com> In-Reply-To: <20250523-drm-doc-updates-v2-0-e517df152cf6@gmail.com> To: Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , Jonathan Corbet Cc: dri-devel@lists.freedesktop.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Abdulrasaq Lawani X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=ed25519-sha256; t=1748029951; l=2194; i=abdulrasaqolawani@gmail.com; s=20250522; h=from:subject:message-id; bh=B7ivfgJeKG6ORpMwQ6TTvaIfeyjPMtOvKMOcVgmHwy4=; b=qZlRVluYXxiLnxUM+U1LYVofi0MtRbN6PU6B4qsz+sqHVTMjWeu1QbYrt4R8LDBoUY/gzGH39 hqrge9M3qLTDOnYpaHhjThT8fcXPMXGv0BnW005xAw94fD98yqyGe6X X-Developer-Key: i=abdulrasaqolawani@gmail.com; a=ed25519; pk=LCvBseqd+rEj8B1vNEnSSfNcqQwMsfWx1DGDT1LYddo= Add an overview diagram of Linux DRM architecture for graphics and compute to introduction.rst --- Documentation/gpu/introduction.rst | 38 ++++++++++++++++++++++++++++++++++= +++- 1 file changed, 37 insertions(+), 1 deletion(-) diff --git a/Documentation/gpu/introduction.rst b/Documentation/gpu/introdu= ction.rst index 3cd0c8860b949408ed570d3f9384edd5f03df002..91bb0efc96d69921a122c5265b1= 431fa18110a7a 100644 --- a/Documentation/gpu/introduction.rst +++ b/Documentation/gpu/introduction.rst @@ -14,7 +14,43 @@ including the TTM memory manager, output configuration a= nd mode setting, and the new vblank internals, in addition to all the regular features found in current kernels. =20 -[Insert diagram of typical DRM stack here] +Overview of the Linux DRM Architecture +----------------------------------------------- ++-----------------------------+ +| User-space Apps | +| (Games, Browsers, ML, etc.) | ++-----------------------------+ + | + v ++---------------------------------------+ +| Graphics APIs | Compute APIs | +| (OpenGL, Vulkan) | (OpenCL, CUDA) | ++---------------------------------------+ + | | + v v ++---------------------+ +-----------------------+ +| User-space Driver | | Compute Runtime | +| (Mesa, AMD/NVIDIA) | | (OpenCL, CUDA, ROCm) | ++---------------------+ +-----------------------+ + | | + +--------+----------+ + | + v + +-----------------------+ + | libdrm (DRM API) | + +-----------------------+ + | + v ++-------------------------------------------+ +| Kernel DRM/KMS Driver (i915, amdgpu, | +| nouveau, etc.) | ++-------------------------------------------+ + | | + v v ++----------------+ +-------------------+ +| GPU Display HW | | GPU Compute Units | ++----------------+ +-------------------+ + =20 Style Guidelines =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 2.43.0 From nobody Fri Dec 19 16:01:36 2025 Received: from mail-qk1-f179.google.com (mail-qk1-f179.google.com [209.85.222.179]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7B1E91B0414; Fri, 23 May 2025 19:52:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.222.179 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748029957; cv=none; b=ZvmhrUydx8KZ+NgeY+/yPGR9BqWiqAJSV5z6jPDbkS74XbK2h7upYC/jVvAROWFrLYE0TfXjCwGo434gW737qqZkUnVWX6Pk107lOv3u8xmCgm5meoM+evRUjm0Ys6kgKsIGPazmrioIS5vogTr2R1Bo9fJPVAq33e7dgW2IwBs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1748029957; c=relaxed/simple; bh=OKaP4B0Xnh5TJoF72fSANLfkmXr2lapzq7QazmotoOE=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=f2fA6dDL488rhIPkXd0cFW8OcZd3xcrkrxLvdvnwuXrXw/IYI0h6YDBeau7iTqhtxinzIpQxPrb/IA97RXHSuYvqYaDlNl6BDho5MHF4oPhDDZYbLDQ2z7QI85k5tTTxokvMkNtbNXbYxmJ/QlwgoA56sDKc47myWyHKeMiamM0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=QYJc6+jI; arc=none smtp.client-ip=209.85.222.179 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="QYJc6+jI" Received: by mail-qk1-f179.google.com with SMTP id af79cd13be357-7cd0a7b672bso12349585a.2; Fri, 23 May 2025 12:52:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1748029954; x=1748634754; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=WmPCjoSXFBtyUZwjoj/rRSZyZWME/2nkz3kS++4dL0o=; b=QYJc6+jIVwQ+LHix3TdIC/7ir5Z32nnU7IwcgzrCe15zoa/vf69421WPzLxmJY5qOf N8oNeMKpID7zQLD+aEWE5bLWenyvUtg/uw2NooansXlXd2qP+LqGNgzbUsREl6YYP69+ I3D8zcE4R2U06nFpdy1zPV3xLndjJ7qws4ZwkDV/NRnrJ0h4cypspEf9Iv+t7VRX2XAq v7EquxIU8PKZ9wNs1hGN/pv+unGtUMZQH7T0zgRlwMfe9ywiLACqQRADOyh3KGKiobNI UcxeWxxKQc+sMfBJn+JW41v4RFt9jRNxh+5QHP+QLzYr+giZA8I2VzA+E8mEvPnYX+1/ zGgg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1748029954; x=1748634754; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=WmPCjoSXFBtyUZwjoj/rRSZyZWME/2nkz3kS++4dL0o=; b=RJJxM2Gz92/8tYOGyIaMTCP0vLEBggjbf2yUt8Ebl0tnr2kYlahpVDUSBcrj9PtDHs 78tmd1ogI8arPxYr2hRpQtfQ91yt2b6oTsSKJD17kPDbSZxQFxM775ZXuTv7kMBa7aog VDgmdVTg5W1jOx5E7qDETslgMZdVW6zoZD4FSBAm9/LliXPCkdep0W6sUsYBgGim0wzI jtMcet6vL9FsdJCgcH6BNGfx29+oqEcGDRWQor2jZqkldPBN9mErELOg/7V8ZkzRCbsY CfFiiQSH4C0aF4jkEJ4OS9CTC6mjD9gmEKV/jiiaCmqH1GK5FfCe6d/Rt8WonZnmaErR tu8A== X-Forwarded-Encrypted: i=1; AJvYcCV/RSzkJgVsAahm6sg0fSgJL1VbFT+EJix5h0nQkkp703swXOU8vEmLC7YdKlSJM0GGm05mfhE9rhc=@vger.kernel.org, AJvYcCXBiM6FjFVSjPrluoY4icpcKmV68agLiCN4IqjX8sC5C0yvWB1V7lk046mcGSoVg4wQWPFhT4NejVTVcEx0@vger.kernel.org X-Gm-Message-State: AOJu0YwNNofKI4sX+9qCVTPXXIPjoHHjHWcLCKufiWC/5awj8PgS/ygl hdlMa1AMR76RYFZApYKDLCS8/XmmcJrht3QnRrHlDMyONE0Cvasf1GZR X-Gm-Gg: ASbGnctGF0wExZkpLVd3AQWGEYXinGeZz2yTlYNj12OGyG1ec/JvNfAe90OEVRHcmZB VPTNef4KgqMqAoVLVkaljvUyzbS+HzDJQBbDjShVA0cm6cUJ27Dr4EkWLlPg+pBn9iR80Q+ktaz CY1Bb45PqLHOgmv7CDw3GnY/qnJROhtr5Ba1kWz3GlD4yocJegum+MsTn9c5tAvcBFm1wDHRR1+ jZEpGyB95VwzQuwut2lg00H7KxqbbKDgFJnCQoicp14gnJztc+aSDZhjRbgJJP3O+pU6Domecm2 M3pre3ZuiWcWS52V7MQqCmVpHMBW11QFLZMdYgrDViutLDvStlcwfFrGHgKSOP1Kvg== X-Google-Smtp-Source: AGHT+IHEPwBBepU5BOws+80VBNcZYVDCzQXJTxhWGn+7xzZI195OkqyZLZqqugwwVyfoO0lqkMvQpA== X-Received: by 2002:a05:622a:4c0e:b0:494:af82:7804 with SMTP id d75a77b69052e-49f46e41135mr8653601cf.29.1748029954290; Fri, 23 May 2025 12:52:34 -0700 (PDT) Received: from [10.0.0.88] ([2607:fea8:bad7:5400:a4e6:39bc:5bd6:cf8f]) by smtp.gmail.com with ESMTPSA id d75a77b69052e-494ae4fd718sm117133001cf.53.2025.05.23.12.52.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 23 May 2025 12:52:33 -0700 (PDT) From: Abdulrasaq Lawani Date: Fri, 23 May 2025 15:52:26 -0400 Subject: [PATCH v2 2/2] drm: add overview diagram for drm stack Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250523-drm-doc-updates-v2-2-e517df152cf6@gmail.com> References: <20250523-drm-doc-updates-v2-0-e517df152cf6@gmail.com> In-Reply-To: <20250523-drm-doc-updates-v2-0-e517df152cf6@gmail.com> To: Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , Jonathan Corbet Cc: dri-devel@lists.freedesktop.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Abdulrasaq Lawani X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=ed25519-sha256; t=1748029951; l=3657; i=abdulrasaqolawani@gmail.com; s=20250522; h=from:subject:message-id; bh=OKaP4B0Xnh5TJoF72fSANLfkmXr2lapzq7QazmotoOE=; b=ykqV2SnKCAiSw0h64hCOwcwDzdGjEq6siC0Lx768zLLib1IaPQvCVP0qmBLUThAToYtOoXtU1 LnvqueGSk+ZAcOyJ06XsiQUpaQMozq9sjVixalqZn/GupAVctm0gERF X-Developer-Key: i=abdulrasaqolawani@gmail.com; a=ed25519; pk=LCvBseqd+rEj8B1vNEnSSfNcqQwMsfWx1DGDT1LYddo= Put overview diagram into a literal block and set its section title to a higher order --- Documentation/gpu/introduction.rst | 72 ++++++++++++++++++++--------------= ---- 1 file changed, 37 insertions(+), 35 deletions(-) diff --git a/Documentation/gpu/introduction.rst b/Documentation/gpu/introdu= ction.rst index 91bb0efc96d69921a122c5265b1431fa18110a7a..2653048ad4bb0ecbc2b67629544= 0442dddbabae6 100644 --- a/Documentation/gpu/introduction.rst +++ b/Documentation/gpu/introduction.rst @@ -15,41 +15,43 @@ and the new vblank internals, in addition to all the re= gular features found in current kernels. =20 Overview of the Linux DRM Architecture ------------------------------------------------ -+-----------------------------+ -| User-space Apps | -| (Games, Browsers, ML, etc.) | -+-----------------------------+ - | - v -+---------------------------------------+ -| Graphics APIs | Compute APIs | -| (OpenGL, Vulkan) | (OpenCL, CUDA) | -+---------------------------------------+ - | | - v v -+---------------------+ +-----------------------+ -| User-space Driver | | Compute Runtime | -| (Mesa, AMD/NVIDIA) | | (OpenCL, CUDA, ROCm) | -+---------------------+ +-----------------------+ - | | - +--------+----------+ - | - v - +-----------------------+ - | libdrm (DRM API) | - +-----------------------+ - | - v -+-------------------------------------------+ -| Kernel DRM/KMS Driver (i915, amdgpu, | -| nouveau, etc.) | -+-------------------------------------------+ - | | - v v -+----------------+ +-------------------+ -| GPU Display HW | | GPU Compute Units | -+----------------+ +-------------------+ +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D +:: + + +-----------------------------+ + | User-space Apps | + | (Games, Browsers, ML, etc.) | + +-----------------------------+ + | + v + +---------------------------------------+ + | Graphics APIs | Compute APIs | + | (OpenGL, Vulkan) | (OpenCL, CUDA) | + +---------------------------------------+ + | | + v v + +---------------------+ +-----------------------+ + | User-space Driver | | Compute Runtime | + | (Mesa, AMD/NVIDIA) | | (OpenCL, CUDA, ROCm) | + +---------------------+ +-----------------------+ + | | + +--------+----------+ + | + v + +-----------------------+ + | libdrm (DRM API) | + +-----------------------+ + | + v + +-------------------------------------------+ + | Kernel DRM/KMS Driver (i915, amdgpu, | + | nouveau, etc.) | + +-------------------------------------------+ + | | + v v + +----------------+ +-------------------+ + | GPU Display HW | | GPU Compute Units | + +----------------+ +-------------------+ =20 =20 Style Guidelines --=20 2.43.0