diff --git a/doc/.keep b/doc/.keep new file mode 100644 index 0000000..e69de29 diff --git a/doc/main.aux b/doc/main.aux new file mode 100644 index 0000000..d4b0173 --- /dev/null +++ b/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} diff --git a/doc/main.log b/doc/main.log new file mode 100644 index 0000000..7c61972 --- /dev/null +++ b/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: +* 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 + +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) + diff --git a/doc/main.pdf b/doc/main.pdf index 216d8e2..2f3a51a 100644 Binary files a/doc/main.pdf and b/doc/main.pdf differ diff --git a/doc/main.tex b/doc/main.tex index 72be3db..43346e5 100644 --- a/doc/main.tex +++ b/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} \ No newline at end of file diff --git a/py/.keep b/py/.keep new file mode 100644 index 0000000..e69de29 diff --git a/py/files.py b/py/files.py new file mode 100644 index 0000000..bfcfe6a --- /dev/null +++ b/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() diff --git a/scripts/.keep b/scripts/.keep new file mode 100644 index 0000000..e69de29 diff --git a/scripts/dnsmasq_config_1.conf b/scripts/dnsmasq_config_1.conf new file mode 100644 index 0000000..cc11592 --- /dev/null +++ b/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 \ No newline at end of file diff --git a/scripts/incus_script_1.sh b/scripts/incus_script_1.sh new file mode 100644 index 0000000..0bb8f0c --- /dev/null +++ b/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 \ No newline at end of file diff --git a/scripts/incus_script_10.sh b/scripts/incus_script_10.sh new file mode 100644 index 0000000..84c7cd5 --- /dev/null +++ b/scripts/incus_script_10.sh @@ -0,0 +1,2 @@ +incus exec dnsmasq-container -- systemctl restart dnsmasq +incus exec dnsmasq-container -- systemctl enable dnsmasq \ No newline at end of file diff --git a/scripts/incus_script_11.sh b/scripts/incus_script_11.sh new file mode 100644 index 0000000..24bd330 --- /dev/null +++ b/scripts/incus_script_11.sh @@ -0,0 +1 @@ +incus exec dnsmasq-container -- systemctl status dnsmasq \ No newline at end of file diff --git a/scripts/incus_script_12.sh b/scripts/incus_script_12.sh new file mode 100644 index 0000000..d3da3c0 --- /dev/null +++ b/scripts/incus_script_12.sh @@ -0,0 +1 @@ +incus exec dnsmasq-container -- nslookup example.local 192.168.1.10 \ No newline at end of file diff --git a/scripts/incus_script_2.sh b/scripts/incus_script_2.sh new file mode 100644 index 0000000..c213fc2 --- /dev/null +++ b/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 \ No newline at end of file diff --git a/scripts/incus_script_3.sh b/scripts/incus_script_3.sh new file mode 100644 index 0000000..6969be6 --- /dev/null +++ b/scripts/incus_script_3.sh @@ -0,0 +1 @@ +incus exec dnsmasq-container -- bash -c 'echo "root:passroot" | chpasswd' \ No newline at end of file diff --git a/scripts/incus_script_4.sh b/scripts/incus_script_4.sh new file mode 100644 index 0000000..d3d1fc9 --- /dev/null +++ b/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 \ No newline at end of file diff --git a/scripts/incus_script_5.sh b/scripts/incus_script_5.sh new file mode 100644 index 0000000..d92924d --- /dev/null +++ b/scripts/incus_script_5.sh @@ -0,0 +1 @@ +incus exec dnsmasq-container -- bash \ No newline at end of file diff --git a/scripts/incus_script_6.sh b/scripts/incus_script_6.sh new file mode 100644 index 0000000..600f2a1 --- /dev/null +++ b/scripts/incus_script_6.sh @@ -0,0 +1,2 @@ +incus exec dnsmasq-container -- apt update +incus exec dnsmasq-container -- apt install dnsmasq -y \ No newline at end of file diff --git a/scripts/incus_script_7.sh b/scripts/incus_script_7.sh new file mode 100644 index 0000000..68c6549 --- /dev/null +++ b/scripts/incus_script_7.sh @@ -0,0 +1 @@ +incus exec dnsmasq-container -- nano /etc/netplan/01-netcfg.yaml \ No newline at end of file diff --git a/scripts/incus_script_8.sh b/scripts/incus_script_8.sh new file mode 100644 index 0000000..93ad32c --- /dev/null +++ b/scripts/incus_script_8.sh @@ -0,0 +1 @@ +incus exec dnsmasq-container -- netplan apply \ No newline at end of file diff --git a/scripts/incus_script_9.sh b/scripts/incus_script_9.sh new file mode 100644 index 0000000..7f885d1 --- /dev/null +++ b/scripts/incus_script_9.sh @@ -0,0 +1 @@ +incus exec dnsmasq-container -- nano /etc/dnsmasq.conf \ No newline at end of file diff --git a/scripts/netplan_config_1.yaml b/scripts/netplan_config_1.yaml new file mode 100644 index 0000000..0bf75d2 --- /dev/null +++ b/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] \ No newline at end of file