CINXE.COM

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd"> <html> <head> <meta http-equiv="X-UA-Compatible" content="IE=Edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <link rel="shortcut icon" href="/htdocs/favicon.ico"> <script type="text/javascript" src="/htdocs/bugstatus.js"></script> <meta http-equiv="Content-Type" content="text/html;charset=utf-8"> <meta name="robots" content="index,nofollow"> <title>DebianLive - Debian Wiki</title> <script type="text/javascript" src="/htdocs/common/js/common.js"></script> <script type="text/javascript">  </script> <link rel="stylesheet" type="text/css" charset="utf-8" media="all" href="/htdocs/debwiki/css/common.css"> <link rel="stylesheet" type="text/css" charset="utf-8" media="screen" href="/htdocs/debwiki/css/screen.css"> <link rel="stylesheet" type="text/css" charset="utf-8" media="print" href="/htdocs/debwiki/css/print.css"> <link rel="stylesheet" type="text/css" charset="utf-8" media="projection" href="/htdocs/debwiki/css/projection.css"> <link rel="stylesheet" type="text/css" charset="utf-8" media="all" href="/htdocs/debian-wiki-1.0.css">   <link rel="alternate" title="Debian Wiki: DebianLive" href="/DebianLive?diffs=1&show_att=1&action=rss_rc&unique=0&page=DebianLive&ddiffs=1" type="application/rss+xml"> <link rel="Start" href="/FrontPage"> <link rel="Alternate" title="Wiki Markup" href="/DebianLive?action=raw"> <link rel="Alternate" media="print" title="Print View" href="/DebianLive?action=print"> <link rel="Search" href="/FindPage"> <link rel="Index" href="/TitleIndex"> <link rel="Glossary" href="/WordIndex"> <link rel="Help" href="/HelpOnFormatting"> </head> <body lang="en" dir="ltr"> <div id="logo"><a href="https://www.debian.org" title="Debian Homepage"><img src="https://www.debian.org/Pics/openlogo-50.png" alt="Debian" width="50" height="61"></a></div> <div id="header"> <div id="wikisection"> <p class="section"><a href="/FrontPage" title="Debian Wiki Homepage">Wiki</a></p> <div id="username"><a href="/DebianLive?action=login" id="login" rel="nofollow">Login</a></div> </div> <div id="navbar"> <ul id="navibar"> <li class="wikilink"><a href="/FrontPage">FrontPage</a></li><li class="wikilink"><a href="/RecentChanges">RecentChanges</a></li><li class="wikilink"><a href="/FindPage">FindPage</a></li><li class="wikilink"><a href="/HelpContents">HelpContents</a></li><li class="current"><a href="/DebianLive">DebianLive</a></li> </ul> </div> <form id="searchform" method="get" action="/DebianLive"> <div> <input type="hidden" name="action" value="fullsearch"> <input type="hidden" name="context" value="180"> <label for="searchinput">Search:</label> <input id="searchinput" type="text" name="value" value="" size="20" onfocus="searchFocus(this)" onblur="searchBlur(this)" onkeyup="searchChange(this)" onchange="searchChange(this)" alt="Search"> <input id="titlesearch" name="titlesearch" type="submit" value="Titles" alt="Search Titles"> <input id="fullsearch" name="fullsearch" type="submit" value="Text" alt="Search Full Text"> </div> </form> <script type="text/javascript">  </script> <div id="logo"><a href="https://www.debian.org" title="Debian Homepage"><img src="https://www.debian.org/Pics/openlogo-50.png" alt="Debian" width="50" height="61"></a></div> <div id="breadcrumbs"><a href="/FrontPage" title="Debian Wiki Homepage">Wiki</a><span class="sep">/</span> </div> <ul class="editbar"><li><a href="/DebianLive?action=login" id="login-1" rel="nofollow">Login</a></li><li class="toggleCommentsButton" style="display:none;"><a href="#" class="nbcomment" onClick="toggleComments();return false;">Comments</a></li><li><a class="nbinfo" href="/DebianLive?action=info" rel="nofollow">Info</a></li><li><a class="nbattachments" href="/DebianLive?action=AttachFile" rel="nofollow">Attachments</a></li><li> <form class="actionsmenu" method="GET" action="/DebianLive"> <div> <label>More Actions:</label> <select name="action" onchange="if ((this.selectedIndex != 0) && (this.options[this.selectedIndex].disabled == false)) { this.form.submit(); } this.selectedIndex = 0;"> <option value="raw">Raw Text</option> <option value="print">Print View</option> <option value="RenderAsDocbook">Render as Docbook</option> <option value="refresh">Delete Cache</option> <option value="show" disabled class="disabled">------------------------</option> <option value="SpellCheck">Check Spelling</option> <option value="LikePages">Like Pages</option> <option value="LocalSiteMap">Local Site Map</option> <option value="show" disabled class="disabled">------------------------</option> <option value="RenamePage" disabled class="disabled">Rename Page</option> <option value="DeletePage" disabled class="disabled">Delete Page</option> <option value="show" disabled class="disabled">------------------------</option> <option value="show" disabled class="disabled">Subscribe User</option> <option value="show" disabled class="disabled">------------------------</option> <option value="show" disabled class="disabled">Remove Spam</option> <option value="show" disabled class="disabled">Revert to this revision</option> <option value="PackagePages">Package Pages</option> <option value="show" disabled class="disabled">------------------------</option> <option value="Load">Load</option> <option value="Save">Save</option> <option value="SlideShow">SlideShow</option> </select> <input type="submit" value="Do"> </div> <script type="text/javascript">  </script> </form> </li></ul> <h1 id="locationline"> <ul id="pagelocation"> <li><a href="/DebianLive">DebianLive</a></li> </ul> </h1> </div> <div id="page" lang="en" dir="ltr"> <div dir="ltr" id="content" lang="en"><span class="anchor" id="top"></span> <span class="anchor" id="line-1"></span><span class="anchor" id="line-2"></span><span class="anchor" id="line-3"></span><span class="anchor" id="line-4"></span><span class="anchor" id="line-5"></span><p class="line867"><small><a href="/DebianWiki/EditorGuide#translation">Translation(s)</a>: <a href="/de/DebianLive">Deutsch</a> - <a href="/DebianLive">English</a> - <a href="/fr/DebianLive">Fran莽ais</a> - <a href="/it/DebianLive">Italiano</a> </small> <span class="anchor" id="line-6"></span><span class="anchor" id="line-7"></span><span class="anchor" id="line-8"></span><p class="line867"><hr /><p class="line874"> <span class="anchor" id="line-9"></span>The Debian Live team produces the tools used by the Debian CD team to produce the Official Debian Live images (from <a href="/DebianStretch">stretch</a> onwards) and also maintains other packages that are used to build live images. <span class="anchor" id="line-10"></span><span class="anchor" id="line-11"></span><p class="line874">Around the time of a release, the Debian Live team liaises with the Debian CD team in order to make sure that releases happen smoothly and with as few issues as possible. <span class="anchor" id="line-12"></span><span class="anchor" id="line-13"></span><p class="line867"> <h1 id="Infrastructure">Infrastructure</h1> <span class="anchor" id="line-14"></span><span class="anchor" id="line-15"></span><ul><li><p class="line862">Homepage: <a class="https" href="https://www.debian.org/CD/live">https://www.debian.org/CD/live</a> <span class="anchor" id="line-16"></span></li><li><p class="line862">Development Homepage: <a class="https" href="https://www.debian.org/devel/debian-live/">https://www.debian.org/devel/debian-live/</a> <span class="anchor" id="line-17"></span></li><li><p class="line862">Development Documentation: <a class="https" href="https://live-team.pages.debian.net/live-manual/">https://live-team.pages.debian.net/live-manual/</a> <span class="anchor" id="line-18"></span></li><li><p class="line862">Mailing List: <a class="mailto" href="mailto:debian-live@lists.debian.org">debian-live@lists.debian.org</a> (<a class="https" href="https://lists.debian.org/debian-live/">Archives</a>) <span class="anchor" id="line-19"></span></li><li><p class="line862">IRC: <a class="irc" href="irc://irc.debian.org/debian-live">#debian-live</a> on OFTC <span class="anchor" id="line-20"></span></li><li><p class="line862">Salsa Group: <a class="https" href="https://salsa.debian.org/live-team/">https://salsa.debian.org/live-team/</a> <span class="anchor" id="line-21"></span></li><li><p class="line862">VCS Browser: <a class="https" href="https://salsa.debian.org/live-team/">https://salsa.debian.org/live-team/</a> <span class="anchor" id="line-22"></span><span class="anchor" id="line-23"></span></li></ul><p class="line867"> <h1 id="Contributing_to_Debian_Live">Contributing to Debian Live</h1> <span class="anchor" id="line-24"></span><span class="anchor" id="line-25"></span><p class="line874">Contributions to the project, such as translations and patches, are welcomed and greatly appreciated. <span class="anchor" id="line-26"></span><span class="anchor" id="line-27"></span><p class="line867"><span class="anchor" id="line-28"></span><span class="anchor" id="line-29"></span><span class="anchor" id="line-30"></span><div class="caution"><span class="anchor" id="line-1-1"></span><p class="line862">It is <strong>important</strong> when submitting a contribution, whether it be for software, documentation or a translation, to <strong>clearly identify its copyright holder and include any applicable licensing statement</strong>. <span class="anchor" id="line-2-1"></span><span class="anchor" id="line-3-1"></span><p class="line874">To be accepted, the contribution must be licensed under the same license as the rest of the package. This is GPL version 3 or later for most packages, but BSD 2-clause for live-wrapper. </div><span class="anchor" id="line-31"></span><span class="anchor" id="line-32"></span><p class="line867"> <h2 id="Development">Development</h2> <span class="anchor" id="line-33"></span><span class="anchor" id="line-34"></span><p class="line862">While in the past the Debian Live team has tended to not use Debian resources for development, we now make use of the <a href="/BTS">Debian BTS</a> and Debian hosted version-control systems for all Debian Live development work. <span class="anchor" id="line-35"></span><span class="anchor" id="line-36"></span><p class="line867"> <h3 id="Getting_Started">Getting Started</h3> <span class="anchor" id="line-37"></span><span class="anchor" id="line-38"></span><p class="line862">If you'd like to dive straight into development, check out the <a class="https" href="https://udd.debian.org/dmd/?email1=debian-live%40lists.debian.org#todo">Debian Live Dashboard</a> and see what there is that needs fixing. If you spot a bug you think you can fix, send an email to the mailing list or chat to us in IRC. If no one else is working on the issue, <a class="https" href="https://www.debian.org/Bugs/server-control">assign yourself as the owner</a> of the bug and submit a patch. <span class="anchor" id="line-39"></span><span class="anchor" id="line-40"></span><p class="line874">Please try to always make sensible and appropriate use of the available systems for discussion, bug reporting and patch submission, as discussed below. <span class="anchor" id="line-41"></span><span class="anchor" id="line-42"></span><p class="line867"> <h3 id="Reporting_Bugs">Reporting Bugs</h3> <span class="anchor" id="line-43"></span><span class="anchor" id="line-44"></span><p class="line862">If you discover a bug, then we would appreciate you reporting it to us. You are very welcome to create a bug report in the Debian Bug Tracking System (BTS) for it, though please first check that one does not already exist for the same issue. You can find documentation on how to submit bugs to the BTS <a class="https" href="https://www.debian.org/Bugs/Reporting">here</a>. <span class="anchor" id="line-45"></span><span class="anchor" id="line-46"></span><p class="line874">However, if you wish to create a patch for the issue yourself, then unless you wish to discuss the problem first, it is typically preferred that you skip creating a bug report and just submit a patch as a merge request (MR) in the web based VCS, though submissions of patches as attachments to bug reports are also acceptable. <span class="anchor" id="line-47"></span><span class="anchor" id="line-48"></span><p class="line874">Note that the BTS is an email based submission system, while the web based VCS platform is gitlab based (Debian hosted). <span class="anchor" id="line-49"></span><span class="anchor" id="line-50"></span><p class="line867"> <h3 id="Code_Contributions">Code Contributions</h3> <span class="anchor" id="line-51"></span><span class="anchor" id="line-52"></span><p class="line874">If you are submitting a patch for a bug that has an associated bug report, then please ensure that the commit log of the patch ends with a line of the form "Closes: #XXXXXX" to help our development tools automate certain aspects of bug <span class="anchor" id="line-53"></span>report management. <span class="anchor" id="line-54"></span><span class="anchor" id="line-55"></span><p class="line874">Please also include "Gbp-Dch: ACTION" hints as appropriate (see the "gbp-dch" man page), though do not use "Ignore" for commits that also have a close hint, otherwise the close hint will not work. <span class="anchor" id="line-56"></span><span class="anchor" id="line-57"></span><p class="line874">Please avoid placing bug numbers in commit and MR titles. <span class="anchor" id="line-58"></span><span class="anchor" id="line-59"></span><p class="line874">If you wish to submit a patch for something that is not a bug, please avoid creating a bug report in the BTS, which is intended exclusively for reporting bugs, obviously. You can submit such a patch either as an MR in the web VCS, or as a patch sent to the public mailing list. If you wish to discuss the change before submission then please send an email to the mailing list. <span class="anchor" id="line-60"></span><span class="anchor" id="line-61"></span><p class="line874">Please try to test patches before submission. <span class="anchor" id="line-62"></span><span class="anchor" id="line-63"></span><p class="line874">If submitting an MR, please be sure to tick the "Allow commits from members who can merge to the target branch" option (under "contribution") to help make work finalising any preparations (such as rebasing) before merging easier. <span class="anchor" id="line-64"></span><span class="anchor" id="line-65"></span><p class="line867"> <h3 id="Large_Code_Contributions">Large Code Contributions</h3> <span class="anchor" id="line-66"></span><span class="anchor" id="line-67"></span><p class="line874">If wishing to undertake larger development works, please discuss this on the mailing list in advance. <span class="anchor" id="line-68"></span><span class="anchor" id="line-69"></span><p class="line874">If you have a large contribution to make which has not already had such discussion take place for any reason, please consider discussing with team members before creating bulk reports/MRs as it may prove helpful to both parties in terms of helping co-ordinate how best to work together to accomplish submitting, reviewing and merging it. <span class="anchor" id="line-70"></span><span class="anchor" id="line-71"></span><p class="line862">If you are a DD/DM and would like to be more involved in the development of Debian Live packages, please join the <a class="https" href="https://salsa.debian.org/live-team/">Salsa group</a>. All members of the Salsa group have commit access to our git repositories, but please do not push changes without first clearing it with one of the named uploaders on the package of the repository you are pushing to. <span class="anchor" id="line-72"></span><span class="anchor" id="line-73"></span><p class="line867"> <h3 id="Repository_Layout">Repository Layout</h3> <span class="anchor" id="line-74"></span><span class="anchor" id="line-75"></span><p class="line874">The Debian Live packages are native packages. This means that there is no upstream or pristine-tar branches and we do not use quilt patches, unlike most other teams in Debian where they are packaging upstream sources. <span class="anchor" id="line-76"></span><span class="anchor" id="line-77"></span><p class="line862">The master branch contains current development work. Tags in the form of "debian/<release>" will mark the commit of each release that has been uploaded to unstable. <span class="anchor" id="line-78"></span><span class="anchor" id="line-79"></span><p class="line862">For managing backports and stable updates, branches may be created within the repositories with the name of "<codename>-pu" for proposed-updates or "<codename>-bpo" for backports. <span class="anchor" id="line-80"></span><span class="anchor" id="line-81"></span><p class="line867"> <h2 id="Documentation">Documentation</h2> <span class="anchor" id="line-82"></span><span class="anchor" id="line-83"></span><p class="line867"> <h3 id="Manual">Manual</h3> <span class="anchor" id="line-84"></span><p class="line874">Documentation exists both within individual projects (for instance the live-build man page components of the live-build repo) and in the dedicated live-manual documentation crate. Contributions to this documentation can be made just the same as any other code contribution. <span class="anchor" id="line-85"></span><span class="anchor" id="line-86"></span><p class="line867"> <h3 id="HowTo">HowTo</h3> <span class="anchor" id="line-87"></span><span class="anchor" id="line-88"></span><ul><li><p class="line891"><a href="/DebianLive/LiveUsbPersistence">Live usb with persistence</a> <span class="anchor" id="line-89"></span><span class="anchor" id="line-90"></span></li></ul><p class="line867"> <h2 id="Translations">Translations</h2> <span class="anchor" id="line-91"></span><span class="anchor" id="line-92"></span><p class="line874">TODO: Need information on how to contribute to translations. <span class="anchor" id="line-93"></span><span class="anchor" id="line-94"></span><p class="line867"> <h1 id="Using_GPG_to_Verify_the_Authenticity_of_Live_CD_Images">Using GPG to Verify the Authenticity of Live CD Images</h1> <span class="anchor" id="line-95"></span><span class="anchor" id="line-96"></span><p class="line874">After downloading the Debian Live CD ISO, the "*SUMS" and "*SUMS.sign" files can help verify that the ISO image you downloaded was created by Debian. <span class="anchor" id="line-97"></span><span class="anchor" id="line-98"></span><p class="line874">At a command line, in the directory into which the Debian Live ISO was downloaded, and using "SHA512SUMS" as an example, validate "SHA512SUMS" with "gpg": <span class="anchor" id="line-99"></span><span class="anchor" id="line-100"></span><p class="line867"><span class="anchor" id="line-101"></span><span class="anchor" id="line-102"></span><pre><span class="anchor" id="line-1"></span>gpg --keyserver keyring.debian.org --verify SHA512SUMS.sign SHA512SUMS</pre><span class="anchor" id="line-103"></span><span class="anchor" id="line-104"></span><p class="line862">As per "<a class="https" href="https://www.debian.org/CD/verify">https://www.debian.org/CD/verify</a>", the output from the above gpg command should contain: <span class="anchor" id="line-105"></span><span class="anchor" id="line-106"></span><p class="line867"><span class="anchor" id="line-107"></span><span class="anchor" id="line-108"></span><span class="anchor" id="line-109"></span><pre><span class="anchor" id="line-1-1"></span>gpg: Signature made Wed 21 Jun 2017 03:45:45 AM CDT <span class="anchor" id="line-2"></span>gpg: using RSA key DF9B9C49EAA9298432589D76DA87E80D6294BE9B</pre><span class="anchor" id="line-110"></span><span class="anchor" id="line-111"></span><p class="line874">If the output from the gpg command contains the above "Signature made" and "RSA key" lines, the ISO file itself can now be validated. So, continuing with the "SHA512SUMS" example: <span class="anchor" id="line-112"></span><span class="anchor" id="line-113"></span><p class="line867"><span class="anchor" id="line-114"></span><span class="anchor" id="line-115"></span><pre><span class="anchor" id="line-1-2"></span>sha512sum --ignore-missing -c SHA512SUMS</pre><span class="anchor" id="line-116"></span><span class="anchor" id="line-117"></span><p class="line874">The output from the above "sha512sum" command should be only this: <span class="anchor" id="line-118"></span><span class="anchor" id="line-119"></span><p class="line867"><span class="anchor" id="line-120"></span><span class="anchor" id="line-121"></span><pre><span class="anchor" id="line-1-3"></span>debian-live-<your-version-arch-and-ui-here>.iso: OK</pre><span class="anchor" id="line-122"></span><span class="anchor" id="line-123"></span><p class="line874">If the output from the above command contained "OK", there can be a good level of confidence that your downloaded Debian Live CD ISO image was sourced by Debian. <span class="anchor" id="line-124"></span><span class="anchor" id="line-125"></span><p class="line867"> <h1 id="TODO">TODO</h1> <span class="anchor" id="line-126"></span><span class="anchor" id="line-127"></span><p class="line862">A TODO list is maintained at <a href="/DebianLive/TODO">/TODO</a> in order to highlight any tasks that require immediate attention before the BTS can be triaged. Later, task management will be performed using the BTS. <span class="anchor" id="line-128"></span><span class="anchor" id="bottom"></span></div><div id="pagebottom"></div> </div> <div id="footer"> <p id="pageinfo" class="info" lang="en" dir="ltr">DebianLive (<a class="nbinfo" href="/DebianLive?action=info" rel="nofollow">last modified 2022-01-01 20:41:08</a>)</p> <ul id="credits"> <li>Debian <a href="https://www.debian.org/legal/privacy">privacy policy</a>, Wiki <a href="/Teams/DebianWiki">team</a>, <a href="https://bugs.debian.org/wiki.debian.org">bugs</a> and <a href="https://salsa.debian.org/debian/wiki.debian.org">config</a>.</li><li>Powered by <a href="https://moinmo.in/" title="This site uses the MoinMoin Wiki software.">MoinMoin</a> and <a href="https://moinmo.in/Python" title="MoinMoin is written in Python.">Python</a>, with hosting provided by <a href="https://www.man-da.de/">Metropolitan Area Network Darmstadt</a>.</li> </ul> </div> </body> </html>