From 0daa0db1bc1f5e6b569f247720d18db48bf78a73 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Andreas=20F=C3=A4rber?= <afaerber@suse.com>
Date: Tue, 11 Jun 2024 17:29:51 +0200
Subject: [PATCH] WIP: Prepare CUDA containers how-to
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Signed-off-by: Andreas Färber <afaerber@suse.com>
---
 articles/nvidia-jetson.asm.xml |  9 ++++
 tasks/nvidia-jetson-cuda.xml   | 91 ++++++++++++++++++++++++++++++++++
 2 files changed, 100 insertions(+)
 create mode 100644 tasks/nvidia-jetson-cuda.xml

diff --git a/articles/nvidia-jetson.asm.xml b/articles/nvidia-jetson.asm.xml
index da71796e6..b317d38d0 100644
--- a/articles/nvidia-jetson.asm.xml
+++ b/articles/nvidia-jetson.asm.xml
@@ -47,6 +47,9 @@
     <resource xml:id="_nvidia-jetson-sidecar-libs" href="../tasks/nvidia-jetson-libs.xml">
       <description>Libraries</description>
     </resource>
+    <resource xml:id="_nvidia-jetson-sidecar-cuda" href="../tasks/nvidia-jetson-cuda.xml">
+      <description>CUDA</description>
+    </resource>
   </resources>
   <!-- References -->
   <!--<resources>
@@ -125,6 +128,11 @@
         <revision><date>2024-06-07</date>
           <revdescription>
             <itemizedlist>
+              <listitem><para>Added sections:</para>
+                <itemizedlist>
+                  <listitem><para>Prepared section on containers</para></listitem>
+                </itemizedlist>
+              </listitem>
               <listitem><para>Changed sections:</para>
                 <itemizedlist>
                   <listitem><para>Updated section on KMP with new simplified package name</para></listitem>
@@ -274,6 +282,7 @@
     <module resourceref="_nvidia-jetson-firmware" renderas="section"/>
     <module resourceref="_nvidia-jetson-sidecar-kmp" renderas="section"/>
     <module resourceref="_nvidia-jetson-sidecar-libs" renderas="section"/>
+    <module resourceref="_nvidia-jetson-sidecar-cuda" renderas="section"/>
     <!--<module resourceref="_reference-example" renderas="section"/>
     <module resourceref="_glue-more-info" renderas="section"/>
     <module resourceref="_glue-whats-next" renderas="section"/>-->
diff --git a/tasks/nvidia-jetson-cuda.xml b/tasks/nvidia-jetson-cuda.xml
new file mode 100644
index 000000000..5687557df
--- /dev/null
+++ b/tasks/nvidia-jetson-cuda.xml
@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- This file originates from the project https://github.com/openSUSE/doc-kit -->
+<!-- This file can be edited downstream. -->
+<!DOCTYPE topic
+[
+  <!ENTITY % entities SYSTEM "../common/generic-entities.ent">
+    %entities;
+]>
+<!-- refers to legacy doc: <add github link to legacy doc piece, if applicable> -->
+<!-- point back to this document with a similar comment added to your legacy doc piece -->
+<!-- refer to README.md for file and id naming conventions -->
+<!-- metadata is dealt with on the assembly level -->
+<topic xml:id="nvidia-jetson-sidecar-cuda"
+ role="task" xml:lang="en"
+ xmlns="http://docbook.org/ns/docbook" version="5.2"
+ xmlns:its="http://www.w3.org/2005/11/its"
+ xmlns:xi="http://www.w3.org/2001/XInclude"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:trans="http://docbook.org/ns/transclusion">
+  <info>
+    <title>Installing &nvidia; &cuda; containers for &nvidia; &jetson; platforms</title><!-- can be changed via merge
+in the assembly -->
+    <!-- add author's e-mail -->
+    <meta name="maintainer" content="stefan.dirsch@suse.com" its:translate="no"/>
+    <abstract><!-- can be changed via merge in the assembly -->
+      <para>
+        &nvidiareg; libraries consume the &nvidia; &jetsonreg; graphics drivers.
+      </para>
+    </abstract>
+  </info>
+  <section xml:id="nvidia-jetson-sidecar-cuda-introduction">
+    <title>Introduction</title>
+    <para>
+      ...
+    </para>
+  </section>
+  <section xml:id="nvidia-jetson-sidecar-cuda-requirements">
+    <title>Requirements</title>
+    <itemizedlist>
+      <listitem>
+        <para>
+          &nvidia; &jetson; &orin; System-on-Module or &nvidia; IGX &orin; based system
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          &sles; 15 SP6 or &slm; 6.0
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Linux kernel modules for &nvidia; &orin; GPU
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          &nvidia; libraries for &nvidia; &orin; GPU
+        </para>
+      </listitem>
+    </itemizedlist>
+  </section>
+  <section xml:id="nvidia-jetson-sidecar-cuda-install">
+    <title>Installing the container</title>
+    <para>
+      Install third-party containers provided by &nvidia;.
+    </para>
+    <procedure>
+      <para>
+        Perform the following steps on your &nvidia; based system.
+      </para>
+      <step>
+        <para>
+          ...:
+        </para>
+<screen>&prompt.user;<command>...</command></screen>
+      </step>
+    </procedure>
+  </section>
+  <section xml:id="nvidia-jetson-sidecar-cuda-summary">
+    <title>Summary</title>
+    <para>
+      ...
+    </para>
+  </section>
+  <section xml:id="nvidia-jetson-sidecar-cuda-troubleshooting">
+    <title>Troubleshooting</title>
+    <para>
+      ...
+    </para>
+  </section>
+</topic>