add files.py

doc/main.aux

@@ -0,0 +1,18 @@
+\relax 
+\@writefile{toc}{\contentsline {section}{\numberline {1}Introduction}{1}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {section}{\numberline {2}Prerequisites}{1}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {section}{\numberline {3}Step-by-Step Configuration}{1}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.1}Creating and Setting Up the Incus Container}{1}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.2}Installing Additional Packages}{1}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.3}Configuring Users and Permissions}{2}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.3.1}Changing the Root Password}{2}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsubsection}{\numberline {3.3.2}Adding a New User}{2}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.4}Accessing the Container}{2}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.5}Installing dnsmasq}{2}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.6}Configuring the Network with Netplan}{2}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.7}Configuring dnsmasq}{3}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.8}Starting and Enabling dnsmasq}{4}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsection}{\numberline {3.9}Testing the Configuration}{4}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {section}{\numberline {4}Troubleshooting}{4}{}\protected@file@percent }
+\@writefile{toc}{\contentsline {section}{\numberline {5}Conclusion}{4}{}\protected@file@percent }
+\gdef \@abspage@last{4}

doc/main.log

@@ -0,0 +1,337 @@
+This is pdfTeX, Version 3.141592653-2.6-1.40.26 (TeX Live 2025/dev/Debian) (preloaded format=pdflatex 2024.12.27)  15 MAY 2025 09:28
+entering extended mode
+ restricted \write18 enabled.
+ %&-line parsing enabled.
+**main
+(./main.tex
+LaTeX2e <2024-11-01>
+L3 programming layer <2024-11-02>
+(/usr/share/texlive/texmf-dist/tex/latex/base/article.cls
+Document Class: article 2024/06/29 v1.4n Standard LaTeX document class
+(/usr/share/texlive/texmf-dist/tex/latex/base/size12.clo
+File: size12.clo 2024/06/29 v1.4n Standard LaTeX file (size option)
+)
+\c@part=\count196
+\c@section=\count197
+\c@subsection=\count198
+\c@subsubsection=\count199
+\c@paragraph=\count266
+\c@subparagraph=\count267
+\c@figure=\count268
+\c@table=\count269
+\abovecaptionskip=\skip49
+\belowcaptionskip=\skip50
+\bibindent=\dimen141
+)
+(/usr/share/texlive/texmf-dist/tex/latex/base/inputenc.sty
+Package: inputenc 2024/02/08 v1.3d Input encoding file
+\inpenc@prehook=\toks17
+\inpenc@posthook=\toks18
+)
+(/usr/share/texlive/texmf-dist/tex/latex/base/fontenc.sty
+Package: fontenc 2021/04/29 v2.0v Standard LaTeX package
+)
+(/usr/share/texmf/tex/latex/lm/lmodern.sty
+Package: lmodern 2015/05/01 v1.6.1 Latin Modern Fonts
+LaTeX Font Info:    Overwriting symbol font `operators' in version `normal'
+(Font)                  OT1/cmr/m/n --> OT1/lmr/m/n on input line 22.
+LaTeX Font Info:    Overwriting symbol font `letters' in version `normal'
+(Font)                  OML/cmm/m/it --> OML/lmm/m/it on input line 23.
+LaTeX Font Info:    Overwriting symbol font `symbols' in version `normal'
+(Font)                  OMS/cmsy/m/n --> OMS/lmsy/m/n on input line 24.
+LaTeX Font Info:    Overwriting symbol font `largesymbols' in version `normal'
+(Font)                  OMX/cmex/m/n --> OMX/lmex/m/n on input line 25.
+LaTeX Font Info:    Overwriting symbol font `operators' in version `bold'
+(Font)                  OT1/cmr/bx/n --> OT1/lmr/bx/n on input line 26.
+LaTeX Font Info:    Overwriting symbol font `letters' in version `bold'
+(Font)                  OML/cmm/b/it --> OML/lmm/b/it on input line 27.
+LaTeX Font Info:    Overwriting symbol font `symbols' in version `bold'
+(Font)                  OMS/cmsy/b/n --> OMS/lmsy/b/n on input line 28.
+LaTeX Font Info:    Overwriting symbol font `largesymbols' in version `bold'
+(Font)                  OMX/cmex/m/n --> OMX/lmex/m/n on input line 29.
+LaTeX Font Info:    Overwriting math alphabet `\mathbf' in version `normal'
+(Font)                  OT1/cmr/bx/n --> OT1/lmr/bx/n on input line 31.
+LaTeX Font Info:    Overwriting math alphabet `\mathsf' in version `normal'
+(Font)                  OT1/cmss/m/n --> OT1/lmss/m/n on input line 32.
+LaTeX Font Info:    Overwriting math alphabet `\mathit' in version `normal'
+(Font)                  OT1/cmr/m/it --> OT1/lmr/m/it on input line 33.
+LaTeX Font Info:    Overwriting math alphabet `\mathtt' in version `normal'
+(Font)                  OT1/cmtt/m/n --> OT1/lmtt/m/n on input line 34.
+LaTeX Font Info:    Overwriting math alphabet `\mathbf' in version `bold'
+(Font)                  OT1/cmr/bx/n --> OT1/lmr/bx/n on input line 35.
+LaTeX Font Info:    Overwriting math alphabet `\mathsf' in version `bold'
+(Font)                  OT1/cmss/bx/n --> OT1/lmss/bx/n on input line 36.
+LaTeX Font Info:    Overwriting math alphabet `\mathit' in version `bold'
+(Font)                  OT1/cmr/bx/it --> OT1/lmr/bx/it on input line 37.
+LaTeX Font Info:    Overwriting math alphabet `\mathtt' in version `bold'
+(Font)                  OT1/cmtt/m/n --> OT1/lmtt/m/n on input line 38.
+)
+(/usr/share/texlive/texmf-dist/tex/latex/geometry/geometry.sty
+Package: geometry 2020/01/02 v5.9 Page Geometry
+
+(/usr/share/texlive/texmf-dist/tex/latex/graphics/keyval.sty
+Package: keyval 2022/05/29 v1.15 key=value parser (DPC)
+\KV@toks@=\toks19
+)
+(/usr/share/texlive/texmf-dist/tex/generic/iftex/ifvtex.sty
+Package: ifvtex 2019/10/25 v1.7 ifvtex legacy package. Use iftex instead.
+
+(/usr/share/texlive/texmf-dist/tex/generic/iftex/iftex.sty
+Package: iftex 2022/02/03 v1.0f TeX engine tests
+))
+\Gm@cnth=\count270
+\Gm@cntv=\count271
+\c@Gm@tempcnt=\count272
+\Gm@bindingoffset=\dimen142
+\Gm@wd@mp=\dimen143
+\Gm@odd@mp=\dimen144
+\Gm@even@mp=\dimen145
+\Gm@layoutwidth=\dimen146
+\Gm@layoutheight=\dimen147
+\Gm@layouthoffset=\dimen148
+\Gm@layoutvoffset=\dimen149
+\Gm@dimlist=\toks20
+)
+(/usr/share/texlive/texmf-dist/tex/latex/listings/listings.sty
+\lst@mode=\count273
+\lst@gtempboxa=\box52
+\lst@token=\toks21
+\lst@length=\count274
+\lst@currlwidth=\dimen150
+\lst@column=\count275
+\lst@pos=\count276
+\lst@lostspace=\dimen151
+\lst@width=\dimen152
+\lst@newlines=\count277
+\lst@lineno=\count278
+\lst@maxwidth=\dimen153
+
+(/usr/share/texlive/texmf-dist/tex/latex/listings/lstpatch.sty
+File: lstpatch.sty 2024/09/23 1.10c (Carsten Heinz)
+)
+(/usr/share/texlive/texmf-dist/tex/latex/listings/lstmisc.sty
+File: lstmisc.sty 2024/09/23 1.10c (Carsten Heinz)
+\c@lstnumber=\count279
+\lst@skipnumbers=\count280
+\lst@framebox=\box53
+)
+(/usr/share/texlive/texmf-dist/tex/latex/listings/listings.cfg
+File: listings.cfg 2024/09/23 1.10c listings configuration
+))
+Package: listings 2024/09/23 1.10c (Carsten Heinz)
+
+(/usr/share/texlive/texmf-dist/tex/latex/xcolor/xcolor.sty
+Package: xcolor 2024/09/29 v3.02 LaTeX color extensions (UK)
+
+(/usr/share/texlive/texmf-dist/tex/latex/graphics-cfg/color.cfg
+File: color.cfg 2016/01/02 v1.6 sample color configuration
+)
+Package xcolor Info: Driver file: pdftex.def on input line 274.
+
+(/usr/share/texlive/texmf-dist/tex/latex/graphics-def/pdftex.def
+File: pdftex.def 2024/04/13 v1.2c Graphics/color driver for pdftex
+)
+(/usr/share/texlive/texmf-dist/tex/latex/graphics/mathcolor.ltx)
+Package xcolor Info: Model `cmy' substituted by `cmy0' on input line 1349.
+Package xcolor Info: Model `hsb' substituted by `rgb' on input line 1353.
+Package xcolor Info: Model `RGB' extended on input line 1365.
+Package xcolor Info: Model `HTML' substituted by `rgb' on input line 1367.
+Package xcolor Info: Model `Hsb' substituted by `hsb' on input line 1368.
+Package xcolor Info: Model `tHsb' substituted by `hsb' on input line 1369.
+Package xcolor Info: Model `HSB' substituted by `hsb' on input line 1370.
+Package xcolor Info: Model `Gray' substituted by `gray' on input line 1371.
+Package xcolor Info: Model `wave' substituted by `hsb' on input line 1372.
+)
+(/usr/share/texlive/texmf-dist/tex/latex/parskip/parskip.sty
+Package: parskip 2021-03-14 v2.0h non-zero parskip adjustments
+
+(/usr/share/texlive/texmf-dist/tex/latex/kvoptions/kvoptions.sty
+Package: kvoptions 2022-06-15 v3.15 Key value format for package options (HO)
+
+(/usr/share/texlive/texmf-dist/tex/generic/ltxcmds/ltxcmds.sty
+Package: ltxcmds 2023-12-04 v1.26 LaTeX kernel commands for general use (HO)
+)
+(/usr/share/texlive/texmf-dist/tex/latex/kvsetkeys/kvsetkeys.sty
+Package: kvsetkeys 2022-10-05 v1.19 Key value parser (HO)
+))
+(/usr/share/texlive/texmf-dist/tex/latex/etoolbox/etoolbox.sty
+Package: etoolbox 2020/10/05 v2.5k e-TeX tools for LaTeX (JAW)
+\etb@tempcnta=\count281
+))
+LaTeX Font Info:    Trying to load font information for T1+lmr on input line 35
+.
+
+(/usr/share/texmf/tex/latex/lm/t1lmr.fd
+File: t1lmr.fd 2015/05/01 v1.6.1 Font defs for Latin Modern
+)
+(/usr/share/texlive/texmf-dist/tex/latex/l3backend/l3backend-pdftex.def
+File: l3backend-pdftex.def 2024-05-08 L3 backend support: PDF output (pdfTeX)
+\l__color_backend_stack_int=\count282
+\l__pdf_internal_box=\box54
+)
+(./main.aux)
+\openout1 = `main.aux'.
+
+LaTeX Font Info:    Checking defaults for OML/cmm/m/it on input line 35.
+LaTeX Font Info:    ... okay on input line 35.
+LaTeX Font Info:    Checking defaults for OMS/cmsy/m/n on input line 35.
+LaTeX Font Info:    ... okay on input line 35.
+LaTeX Font Info:    Checking defaults for OT1/cmr/m/n on input line 35.
+LaTeX Font Info:    ... okay on input line 35.
+LaTeX Font Info:    Checking defaults for T1/cmr/m/n on input line 35.
+LaTeX Font Info:    ... okay on input line 35.
+LaTeX Font Info:    Checking defaults for TS1/cmr/m/n on input line 35.
+LaTeX Font Info:    ... okay on input line 35.
+LaTeX Font Info:    Checking defaults for OMX/cmex/m/n on input line 35.
+LaTeX Font Info:    ... okay on input line 35.
+LaTeX Font Info:    Checking defaults for U/cmr/m/n on input line 35.
+LaTeX Font Info:    ... okay on input line 35.
+
+*geometry* driver: auto-detecting
+*geometry* detected driver: pdftex
+*geometry* verbose mode - [ preamble ] result:
+* driver: pdftex
+* paper: a4paper
+* layout: <same size as paper>
+* layoutoffset:(h,v)=(0.0pt,0.0pt)
+* modes: 
+* h-part:(L,W,R)=(72.26999pt, 452.9679pt, 72.26999pt)
+* v-part:(T,H,B)=(72.26999pt, 700.50687pt, 72.26999pt)
+* \paperwidth=597.50787pt
+* \paperheight=845.04684pt
+* \textwidth=452.9679pt
+* \textheight=700.50687pt
+* \oddsidemargin=0.0pt
+* \evensidemargin=0.0pt
+* \topmargin=-37.0pt
+* \headheight=12.0pt
+* \headsep=25.0pt
+* \topskip=12.0pt
+* \footskip=30.0pt
+* \marginparwidth=35.0pt
+* \marginparsep=10.0pt
+* \columnsep=10.0pt
+* \skip\footins=10.8pt plus 4.0pt minus 2.0pt
+* \hoffset=0.0pt
+* \voffset=0.0pt
+* \mag=1000
+* \@twocolumnfalse
+* \@twosidefalse
+* \@mparswitchfalse
+* \@reversemarginfalse
+* (1in=72.27pt=25.4mm, 1cm=28.453pt)
+
+\c@lstlisting=\count283
+(/usr/share/texlive/texmf-dist/tex/context/base/mkii/supp-pdf.mkii
+[Loading MPS to PDF converter (version 2006.09.02).]
+\scratchcounter=\count284
+\scratchdimen=\dimen154
+\scratchbox=\box55
+\nofMPsegments=\count285
+\nofMParguments=\count286
+\everyMPshowfont=\toks22
+\MPscratchCnt=\count287
+\MPscratchDim=\dimen155
+\MPnumerator=\count288
+\makeMPintoPDFobject=\count289
+\everyMPtoPDFconversion=\toks23
+)
+LaTeX Font Info:    Trying to load font information for OT1+lmr on input line 4
+0.
+ (/usr/share/texmf/tex/latex/lm/ot1lmr.fd
+File: ot1lmr.fd 2015/05/01 v1.6.1 Font defs for Latin Modern
+)
+LaTeX Font Info:    Trying to load font information for OML+lmm on input line 4
+0.
+
+(/usr/share/texmf/tex/latex/lm/omllmm.fd
+File: omllmm.fd 2015/05/01 v1.6.1 Font defs for Latin Modern
+)
+LaTeX Font Info:    Trying to load font information for OMS+lmsy on input line 
+40.
+
+(/usr/share/texmf/tex/latex/lm/omslmsy.fd
+File: omslmsy.fd 2015/05/01 v1.6.1 Font defs for Latin Modern
+)
+LaTeX Font Info:    Trying to load font information for OMX+lmex on input line 
+40.
+
+(/usr/share/texmf/tex/latex/lm/omxlmex.fd
+File: omxlmex.fd 2015/05/01 v1.6.1 Font defs for Latin Modern
+)
+LaTeX Font Info:    External font `lmex10' loaded for size
+(Font)              <14.4> on input line 40.
+LaTeX Font Info:    External font `lmex10' loaded for size
+(Font)              <10> on input line 40.
+LaTeX Font Info:    External font `lmex10' loaded for size
+(Font)              <7> on input line 40.
+LaTeX Font Info:    Trying to load font information for T1+lmtt on input line 4
+3.
+
+(/usr/share/texmf/tex/latex/lm/t1lmtt.fd
+File: t1lmtt.fd 2015/05/01 v1.6.1 Font defs for Latin Modern
+)
+LaTeX Font Info:    Trying to load font information for TS1+lmr on input line 4
+8.
+
+(/usr/share/texmf/tex/latex/lm/ts1lmr.fd
+File: ts1lmr.fd 2015/05/01 v1.6.1 Font defs for Latin Modern
+)
+(/usr/share/texlive/texmf-dist/tex/latex/listings/lstlang1.sty
+File: lstlang1.sty 2024/09/23 1.10c listings language file
+)
+(/usr/share/texlive/texmf-dist/tex/latex/listings/lstlang1.sty
+File: lstlang1.sty 2024/09/23 1.10c listings language file
+)
+Overfull \hbox (23.59369pt too wide) in paragraph at lines 65--66
+\T1/lmr/m/n/12 The \T1/lmtt/m/n/12 security.syscalls.intercept.mount\T1/lmr/m/n
+/12 , \T1/lmtt/m/n/12 security.nesting\T1/lmr/m/n/12 , and \T1/lmtt/m/n/12 secu
+rity.privileged
+ []
+
+
+
+[1
+
+{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map}{/usr/share/texmf/fonts/enc/
+dvips/lm/lm-ec.enc}{/usr/share/texmf/fonts/enc/dvips/lm/lm-ts1.enc}]
+
+[2]
+LaTeX Font Info:    Font shape `T1/lmtt/bx/n' in size <10.95> not available
+(Font)              Font shape `T1/lmtt/b/n' tried instead on input line 117.
+
+Overfull \hbox (25.69144pt too wide) in paragraph at lines 164--165
+[]\T1/lmtt/m/n/12 dhcp-range\T1/lmr/m/n/12 : De-fines the IP range for DHCP cli
+ents (from 192.168.1.100 to 192.168.1.200,
+ []
+
+
+
+[3]
+
+[4] (./main.aux)
+ ***********
+LaTeX2e <2024-11-01>
+L3 programming layer <2024-11-02>
+ ***********
+ ) 
+Here is how much of TeX's memory you used:
+ 5009 strings out of 473362
+ 72806 string characters out of 5723554
+ 842560 words of memory out of 5000000
+ 28076 multiletter control sequences out of 15000+600000
+ 598499 words of font info for 61 fonts, out of 8000000 for 9000
+ 1141 hyphenation exceptions out of 8191
+ 57i,6n,65p,493b,1661s stack positions out of 10000i,1000n,20000p,200000b,200000s
+</usr/share/texmf/fonts/type1/public/lm/lmbx12.pfb></usr/share/texmf/fonts/ty
+pe1/public/lm/lmr12.pfb></usr/share/texmf/fonts/type1/public/lm/lmr17.pfb></usr
+/share/texmf/fonts/type1/public/lm/lmr6.pfb></usr/share/texmf/fonts/type1/publi
+c/lm/lmtk10.pfb></usr/share/texmf/fonts/type1/public/lm/lmtt10.pfb></usr/share/
+texmf/fonts/type1/public/lm/lmtt12.pfb>
+Output written on main.pdf (4 pages, 199974 bytes).
+PDF statistics:
+ 57 PDF objects out of 1000 (max. 8388607)
+ 35 compressed objects within 1 object stream
+ 0 named destinations out of 1000 (max. 500000)
+ 1 words of extra memory for PDF output out of 10000 (max. 10000000)
+

doc/main.tex

@@ -19,6 +19,19 @@
   stringstyle=\color{red}
 }
 
+% Define YAML language for listings
+\lstdefinelanguage{yaml}{
+  keywords={true,false,null,yaml,network,version,ethernets,dhcp4,addresses,routes,to,via,nameservers},
+  keywordstyle=\color{blue}\bfseries,
+  basicstyle=\ttfamily\small,
+  sensitive=false,
+  comment=[l]{\#},
+  commentstyle=\color{gray}\itshape,
+  stringstyle=\color{red},
+  morestring=[b]{"},
+  morestring=[b]{'}
+}
+
 \begin{document}
 
 \title{Basic Configuration of dnsmasq in an Incus Container on Debian with Netplan}
@@ -41,34 +54,63 @@ Before proceeding, ensure the following:
 \section{Step-by-Step Configuration}
 
 \subsection{Creating and Setting Up the Incus Container}
-% Creating the Incus container
-Create a Debian container named \texttt{dnsmasq-container} using the following command on the host:
+Create a Debian container named \texttt{dnsmasq-container} using the following commands on the host:
 \begin{lstlisting}[language=bash]
 incus create images:debian/12 dnsmasq-container
 incus config set dnsmasq-container security.syscalls.intercept.mount true
+incus config set dnsmasq-container security.nesting true
+incus config set dnsmasq-container security.privileged true
 incus start dnsmasq-container
 \end{lstlisting}
-The \texttt{security.syscalls.intercept.mount} setting is required for \texttt{dnsmasq} to function correctly in the container.
+The \texttt{security.syscalls.intercept.mount}, \texttt{security.nesting}, and \texttt{security.privileged} settings are required for \texttt{dnsmasq} and Docker to function correctly in the container.
 
-% Accessing the container
-Access the container:
+\subsection{Installing Additional Packages}
+Install the necessary packages inside the container:
+\begin{lstlisting}[language=bash]
+incus exec dnsmasq-container -- apt update
+incus exec dnsmasq-container -- apt install -y \
+    netplan.io \
+    sudo vim nano git tmux mc zip unzip curl wget htop lynx \
+    iproute2 termshark bridge-utils \
+    python3 python3-ipython python3-pyroute2 python3-scapy \
+    docker.io docker-compose
+\end{lstlisting}
+
+\subsection{Configuring Users and Permissions}
+Configure user access and permissions within the container.
+
+\subsubsection{Changing the Root Password}
+Set the root password to "passroot":
+\begin{lstlisting}[language=bash]
+incus exec dnsmasq-container -- bash -c 'echo "root:passroot" | chpasswd'
+\end{lstlisting}
+
+\subsubsection{Adding a New User}
+Add a new user named "user" with the password "pass" and add them to the "sudo" and "docker" groups:
+\begin{lstlisting}[language=bash]
+incus exec dnsmasq-container -- useradd -m -s /bin/bash user
+incus exec dnsmasq-container -- bash -c 'echo "user:pass" | chpasswd'
+incus exec dnsmasq-container -- usermod -aG sudo user
+incus exec dnsmasq-container -- usermod -aG docker user
+\end{lstlisting}
+
+\subsection{Accessing the Container}
+Access the container's shell:
 \begin{lstlisting}[language=bash]
 incus exec dnsmasq-container -- bash
 \end{lstlisting}
 
 \subsection{Installing dnsmasq}
-% Installing dnsmasq and dependencies
 Update the package list and install \texttt{dnsmasq}:
 \begin{lstlisting}[language=bash]
-apt update
-apt install dnsmasq -y
+incus exec dnsmasq-container -- apt update
+incus exec dnsmasq-container -- apt install dnsmasq -y
 \end{lstlisting}
 
 \subsection{Configuring the Network with Netplan}
-% Setting up the network interface
-Configure the container's network using Netplan to assign a static IP address. Edit the Netplan configuration file (e.g., \texttt{/etc/netplan/01-netcfg.yaml}):
+Configure the container's network using Netplan to assign a static IP address. Create or edit the Netplan configuration file at \texttt{/etc/netplan/01-netcfg.yaml}:
 \begin{lstlisting}[language=bash]
-nano /etc/netplan/01-netcfg.yaml
+incus exec dnsmasq-container -- nano /etc/netplan/01-netcfg.yaml
 \end{lstlisting}
 Add the following configuration:
 \begin{lstlisting}[language=yaml]
@@ -79,20 +121,21 @@ network:
       dhcp4: no
       addresses:
         - 192.168.1.10/24
-      gateway4: 192.168.1.1
+      routes:
+        - to: default
+          via: 192.168.1.1
       nameservers:
         addresses: [8.8.8.8, 8.8.4.4]
 \end{lstlisting}
 Apply the configuration:
 \begin{lstlisting}[language=bash]
-netplan apply
+incus exec dnsmasq-container -- netplan apply
 \end{lstlisting}
 
 \subsection{Configuring dnsmasq}
-% Configuring dnsmasq for DNS and DHCP
 Edit the \texttt{dnsmasq} configuration file at \texttt{/etc/dnsmasq.conf}:
 \begin{lstlisting}[language=bash]
-nano /etc/dnsmasq.conf
+incus exec dnsmasq-container -- nano /etc/dnsmasq.conf
 \end{lstlisting}
 Add or modify the following settings to enable DNS and DHCP:
 \begin{lstlisting}
@@ -123,34 +166,32 @@ dhcp-option=6,8.8.8.8,8.8.4.4
 \end{itemize}
 
 \subsection{Starting and Enabling dnsmasq}
-% Starting the dnsmasq service
-Restart the \texttt{dnsmasq} service to apply the configuration:
+Restart and enable the \texttt{dnsmasq} service:
 \begin{lstlisting}[language=bash]
-systemctl restart dnsmasq
-systemctl enable dnsmasq
+incus exec dnsmasq-container -- systemctl restart dnsmasq
+incus exec dnsmasq-container -- systemctl enable dnsmasq
 \end{lstlisting}
 Verify that \texttt{dnsmasq} is running:
 \begin{lstlisting}[language=bash]
-systemctl status dnsmasq
+incus exec dnsmasq-container -- systemctl status dnsmasq
 \end{lstlisting}
 
 \subsection{Testing the Configuration}
-% Testing DNS and DHCP
-Test the DNS resolution from within the container:
+Test DNS resolution from within the container:
 \begin{lstlisting}[language=bash]
-nslookup example.local 192.168.1.10
+incus exec dnsmasq-container -- nslookup example.local 192.168.1.10
 \end{lstlisting}
 To test DHCP, connect a client device to the same network and verify that it receives an IP address in the range \texttt{192.168.1.100--192.168.1.200}.
 
 \section{Troubleshooting}
 If \texttt{dnsmasq} fails to start:
 \begin{itemize}
-  \item Check the logs: \texttt{journalctl -u dnsmasq}.
+  \item Check the logs: \texttt{incus exec dnsmasq-container -- journalctl -u dnsmasq}.
   \item Ensure no other service is using port 53 (DNS) or 67 (DHCP).
-  \item Verify the network configuration with \texttt{ip a} and \texttt{ping 8.8.8.8}.
+  \item Verify the network configuration with \texttt{incus exec dnsmasq-container -- ip a} and \texttt{incus exec dnsmasq-container -- ping 8.8.8.8}.
 \end{itemize}
 
 \section{Conclusion}
 This guide configures \texttt{dnsmasq} as a DNS and DHCP server in an Incus container on Debian. The Netplan configuration ensures proper network setup. For advanced configurations, refer to the \texttt{dnsmasq} documentation (\texttt{man dnsmasq}).
 
-\end{document}
+\end{document}

py/files.py

@@ -0,0 +1,91 @@
+import re
+from pathlib import Path
+
+def get_file_extension_and_default_name(attributes: str, code: str) -> tuple[str, str]:
+    """Determine file extension and default name based on attributes and content."""
+    # Extract language from attributes (e.g., language=bash)
+    language_match = re.search(r'language=(\w+)', attributes)
+    language = language_match.group(1).lower() if language_match else 'unknown'
+
+    if language == 'bash' or 'incus' in code.lower():
+        return '.sh', 'incus_script'
+    elif language == 'yaml':
+        return '.yaml', 'netplan_config'
+    elif language == 'python':
+        return '.py', 'python_script'
+    else:
+        # Assume .conf for blocks without language or resembling config
+        return '.conf', 'dnsmasq_config'
+
+def generate_unique_filename(base_dir: Path, base_name: str, extension: str) -> Path:
+    """Generate a unique filename by appending a number if the file exists."""
+    counter = 1
+    while True:
+        filename = f"{base_name}_{counter}{extension}"
+        file_path = base_dir / filename
+        if not file_path.exists():
+            return file_path
+        counter += 1
+
+def extract_listings():
+    """Extract lstlisting code blocks from main.tex and save to scripts folder."""
+    # Define paths
+    base_dir = Path(__file__).parent.parent  # ~/edu/paso/dnsmasq
+    tex_file = base_dir / 'doc' / 'main.tex'
+    scripts_dir = base_dir / 'scripts'
+
+    # Ensure scripts directory exists
+    scripts_dir.mkdir(exist_ok=True)
+
+    # Read the LaTeX file
+    try:
+        with open(tex_file, 'r', encoding='utf-8') as f:
+            content = f.read()
+    except FileNotFoundError:
+        print(f"Error: {tex_file} not found")
+        return
+    except Exception as e:
+        print(f"Error reading {tex_file}: {str(e)}")
+        return
+
+    # Regex to match lstlisting environments
+    # Captures optional attributes [language=...,label=...] and code block content
+    pattern = r'\\begin\{lstlisting\}(\[(.*?)\])?(.*?)\\end\{lstlisting\}'
+    matches = re.finditer(pattern, content, re.DOTALL)
+
+    extracted_count = 0
+
+    for match in matches:
+        # Extract attributes (if any) and code
+        attributes = match.group(2) or ''  # Empty string if no attributes
+        code = match.group(3).strip()
+
+        # Extract label from attributes (e.g., label={setup_container})
+        label_match = re.search(r'label=\{([^}]+)\}', attributes)
+        label = label_match.group(1) if label_match else None
+
+        # Get file extension and default name
+        extension, default_name = get_file_extension_and_default_name(attributes, code)
+
+        # Use label if available, otherwise use default name
+        base_name = label if label else default_name
+
+        # Generate unique filename
+        file_path = generate_unique_filename(scripts_dir, base_name, extension)
+
+        # Save the code block to a file
+        try:
+            with open(file_path, 'w', encoding='utf-8') as f:
+                f.write(code)
+            print(f"Saved code block to {file_path}")
+            extracted_count += 1
+        except Exception as e:
+            print(f"Error saving {file_path}: {str(e)}")
+
+    if extracted_count == 0:
+        print("No lstlisting code blocks found in main.tex")
+    else:
+        print(f"Completed: Extracted {extracted_count} code block(s) to {scripts_dir}")
+
+if __name__ == "__main__":
+    extract_listings()

scripts/dnsmasq_config_1.conf

@@ -0,0 +1,13 @@
+# DNS settings
+domain-needed
+bogus-priv
+no-resolv
+server=8.8.8.8
+server=8.8.4.4
+local=/example.local/
+domain=example.local
+
+# DHCP settings
+dhcp-range=192.168.1.100,192.168.1.200,12h
+dhcp-option=3,192.168.1.1
+dhcp-option=6,8.8.8.8,8.8.4.4

scripts/incus_script_1.sh

@@ -0,0 +1,5 @@
+incus create images:debian/12 dnsmasq-container
+incus config set dnsmasq-container security.syscalls.intercept.mount true
+incus config set dnsmasq-container security.nesting true
+incus config set dnsmasq-container security.privileged true
+incus start dnsmasq-container

scripts/incus_script_10.sh

@@ -0,0 +1,2 @@
+incus exec dnsmasq-container -- systemctl restart dnsmasq
+incus exec dnsmasq-container -- systemctl enable dnsmasq

scripts/incus_script_11.sh

@@ -0,0 +1 @@
+incus exec dnsmasq-container -- systemctl status dnsmasq

scripts/incus_script_12.sh

@@ -0,0 +1 @@
+incus exec dnsmasq-container -- nslookup example.local 192.168.1.10

scripts/incus_script_2.sh

@@ -0,0 +1,7 @@
+incus exec dnsmasq-container -- apt update
+incus exec dnsmasq-container -- apt install -y \
+    netplan.io \
+    sudo vim nano git tmux mc zip unzip curl wget htop lynx \
+    iproute2 termshark bridge-utils \
+    python3 python3-ipython python3-pyroute2 python3-scapy \
+    docker.io docker-compose

scripts/incus_script_3.sh

@@ -0,0 +1 @@
+incus exec dnsmasq-container -- bash -c 'echo "root:passroot" | chpasswd'

scripts/incus_script_4.sh

@@ -0,0 +1,4 @@
+incus exec dnsmasq-container -- useradd -m -s /bin/bash user
+incus exec dnsmasq-container -- bash -c 'echo "user:pass" | chpasswd'
+incus exec dnsmasq-container -- usermod -aG sudo user
+incus exec dnsmasq-container -- usermod -aG docker user

scripts/incus_script_5.sh

@@ -0,0 +1 @@
+incus exec dnsmasq-container -- bash

scripts/incus_script_6.sh

@@ -0,0 +1,2 @@
+incus exec dnsmasq-container -- apt update
+incus exec dnsmasq-container -- apt install dnsmasq -y

scripts/incus_script_7.sh

@@ -0,0 +1 @@
+incus exec dnsmasq-container -- nano /etc/netplan/01-netcfg.yaml

scripts/incus_script_8.sh

@@ -0,0 +1 @@
+incus exec dnsmasq-container -- netplan apply

scripts/incus_script_9.sh

@@ -0,0 +1 @@
+incus exec dnsmasq-container -- nano /etc/dnsmasq.conf

scripts/netplan_config_1.yaml

@@ -0,0 +1,12 @@
+network:
+  version: 2
+  ethernets:
+    eth0:
+      dhcp4: no
+      addresses:
+        - 192.168.1.10/24
+      routes:
+        - to: default
+          via: 192.168.1.1
+      nameservers:
+        addresses: [8.8.8.8, 8.8.4.4]