Guide_3DS/f3-(linux).html

596 lines
21 KiB
HTML

<!doctype html>
<!--
Minimal Mistakes Jekyll Theme 4.24.0 by Michael Rose
Copyright 2013-2020 Michael Rose - mademistakes.com | @mmistakes
Free for personal and commercial use under the MIT license
https://github.com/mmistakes/minimal-mistakes/blob/master/LICENSE
-->
<!-- for guide purposes all caching is removed and is separately built. -->
<html lang="en" class="no-js">
<head>
<meta charset="utf-8">
<!-- begin _includes/seo.html --><title>F3 (Linux) - 3DS Hacks Guide</title>
<meta name="description" content="A complete guide to 3DS custom firmware">
<meta name="author" content="Nintendo Homebrew">
<meta property="og:type" content="website">
<meta property="og:locale" content="en_US">
<meta property="og:site_name" content="3DS Hacks Guide">
<meta property="og:title" content="F3 (Linux)">
<meta property="og:url" content="https://3ds.hacks.guide/f3-(linux).html">
<meta property="og:description" content="A complete guide to 3DS custom firmware">
<link rel="canonical" href="https://3ds.hacks.guide/f3-(linux).html">
<script type="application/ld+json">
{
"@context": "https://schema.org",
"@type": "Person",
"name": "Nintendo Homebrew",
"url": "https://3ds.hacks.guide/"
}
</script>
<meta name="google-site-verification" content="jVXoPK_-qzKJp4SScnZYpOIX3yDXfGnAoTBJYixUOwg" />
<meta name="msvalidate.01" content="F3532011519E308583A0A2CAF2DD69E8">
<!-- end _includes/seo.html -->
<link href="/feed.xml" type="application/atom+xml" rel="alternate" title="3DS Hacks Guide Feed">
<!-- https://t.co/dKP3o1e -->
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<script>
document.documentElement.className = document.documentElement.className.replace(/\bno-js\b/g, '') + ' js ';
</script>
<!-- For all browsers -->
<link rel="stylesheet" href="/assets/css/main.css">
<link rel="preload" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5/css/all.min.css" as="style" onload="this.onload=null;this.rel='stylesheet'">
<noscript><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5/css/all.min.css"></noscript>
<!-- start custom head snippets -->
<!-- insert favicons. use http://realfavicongenerator.net/ -->
<link rel="apple-touch-icon" sizes="180x180" href="/images/apple-touch-icon.png?v=PYEmwKvQAx">
<link rel="icon" type="image/png" href="/images/favicon-32x32.png?v=PYEmwKvQAx" sizes="32x32">
<link rel="icon" type="image/png" href="/images/favicon-194x194.png?v=PYEmwKvQAx" sizes="194x194">
<link rel="icon" type="image/png" href="/images/android-chrome-192x192.png?v=PYEmwKvQAx" sizes="192x192">
<link rel="icon" type="image/png" href="/images/favicon-16x16.png?v=PYEmwKvQAx" sizes="16x16">
<link rel="manifest" href="/images/manifest.json?v=PYEmwKvQAx">
<link rel="mask-icon" href="/images/safari-pinned-tab.svg?v=PYEmwKvQAx" color="#2E3440">
<link rel="shortcut icon" href="/images/favicon.ico?v=PYEmwKvQAx">
<meta name="apple-mobile-web-app-title" content="Guide">
<meta name="application-name" content="Guide">
<meta name="msapplication-TileColor" content="#2E3440">
<meta name="msapplication-TileImage" content="/images/mstile-144x144.png?v=PYEmwKvQAx">
<meta name="msapplication-config" content="/images/browserconfig.xml?v=PYEmwKvQAx">
<meta name="theme-color" content="#2E3440">
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/cookieconsent2/3.1.1/cookieconsent.min.css" integrity="sha512-LQ97camar/lOliT/MqjcQs5kWgy6Qz/cCRzzRzUCfv0fotsCTC9ZHXaPQmJV8Xu/PVALfJZ7BDezl5lW3/qBxg==" crossorigin="anonymous" referrerpolicy="no-referrer" />
<script src="https://cdnjs.cloudflare.com/ajax/libs/cookieconsent2/3.1.1/cookieconsent.min.js" integrity="sha512-yXXqOFjdjHNH1GND+1EO0jbvvebABpzGKD66djnUfiKlYME5HGMUJHoCaeE4D5PTG2YsSJf6dwqyUUvQvS0vaA==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
<script>
window.addEventListener("load", function(){
window.cookieconsent.initialise({
"palette": {
"popup": {
"background": "#2e3440"
},
"button": {
"background": "#60818f"
}
},
"theme": "edgeless",
"position": "top",
"static": true,
"content": {
"message": "This website uses cookies to display the current guide progress on the sidebar and otherwise enhance the site."
}
})});
</script>
<!-- end custom head snippets -->
</head>
<body class="layout--single">
<nav class="skip-links">
<ul>
<li><a href="#site-nav" class="screen-reader-shortcut">Skip to primary navigation</a></li>
<li><a href="#main" class="screen-reader-shortcut">Skip to content</a></li>
<li><a href="#footer" class="screen-reader-shortcut">Skip to footer</a></li>
</ul>
</nav>
<!--[if lt IE 9]>
<div class="notice--danger align-center" style="margin: 0;">You are using an <strong>outdated</strong> browser. Please <a href="https://browsehappy.com/">upgrade your browser</a> to improve your experience.</div>
<![endif]-->
<div class="masthead">
<div class="masthead__inner-wrap">
<div class="masthead__menu">
<nav id="site-nav" class="greedy-nav">
<!-- <a class="site-title" href="/">
3DS Hacks Guide
</a>
-->
<ul class="visible-links">
<!-- modified to use multilang, guide-specific -->
<li class="masthead__menu-item masthead__menu-item--lg"><a href="/">Home</a></li>
<li class="masthead__menu-item"><a href="/faq">FAQ</a></li>
<li class="masthead__menu-item"><a href="/troubleshooting">Troubleshooting</a></li>
<li class="masthead__menu-item"><a href="/checking-for-cfw">Checking for CFW</a></li>
<li class="masthead__menu-item"><a href="/godmode9-usage">GodMode9 Usage</a></li>
<li class="masthead__menu-item"><a href="/contribute">Contribute</a></li>
<li class="masthead__menu-item"><a href="/region-changing">Region Changing</a></li>
<li class="masthead__menu-item"><a href="/uninstall-cfw">Uninstall CFW</a></li>
<li class="masthead__menu-item"><a href="/credits">Credits</a></li>
<li class="masthead__menu-item"><a href="/site-navigation">Site Navigation</a></li>
<!-- end guide specific -->
</ul>
<!-- completely redo hidden links for multilang, guide-specific -->
<ul class="hidden-links links-menu hidden"></ul>
<ul class="hidden-links lang-menu hidden">
<li class="masthead__menu-item"><a href="https://3ds.hacks.guide/f3-(linux).html">English</a></li>
<li class="masthead__menu-item"><a href="https://3ds.hacks.guide/es_ES/f3-(linux).html">Español</a></li>
<li class="masthead__menu-item"><a href="https://3ds.hacks.guide/de_DE/f3-(linux).html">Deutsch</a></li>
<li class="masthead__menu-item"><a href="https://3ds.hacks.guide/fr_FR/f3-(linux).html">Français</a></li>
<li class="masthead__menu-item"><a href="https://3ds.hacks.guide/it_IT/f3-(linux).html">Italiano</a></li>
<li class="masthead__menu-item"><a href="https://3ds.hacks.guide/nl_NL/f3-(linux).html">Nederlands</a></li>
<li class="masthead__menu-item"><a href="https://3ds.hacks.guide/pt_BR/f3-(linux).html">Português do Brasil</a></li>
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/pt_PT/f3-(linux).html">Português (Portugal)</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/ru_RU/f3-(linux).html">Русский</a></li> -->
<li class="masthead__menu-item"><a href="https://3ds.hacks.guide/zh_CN/f3-(linux).html">简体中文</a></li>
<li class="masthead__menu-item"><a href="https://3ds.hacks.guide/zh_TW/f3-(linux).html">繁體中文</a></li>
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/pl_PL/f3-(linux).html">Polski</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/tr_TR/f3-(linux).html">Türkçe</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/vi_VN/f3-(linux).html">Tiếng Việt</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/ca_ES/f3-(linux).html">Català</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/el_GR/f3-(linux).html">Ελληνικά</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/he_IL/f3-(linux).html">עברית‎</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/sv_SE/f3-(linux).html">Svenska</a></li> -->
<li class="masthead__menu-item"><a href="https://3ds.hacks.guide/ko_KR/f3-(linux).html">한국어</a></li>
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/no_NO/f3-(linux).html">Norsk</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/ja_JP/f3-(linux).html">日本語</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/ar_SA/f3-(linux).html">اللغة العربية</a></li> -->
<li class="masthead__menu-item"><a href="https://3ds.hacks.guide/hu_HU/f3-(linux).html">Magyar</a></li>
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/ro_RO/f3-(linux).html">Română</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/sr_SP/f3-(linux).html">Српски</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/af_ZA/f3-(linux).html">Afrikaans</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/ms_MY/f3-(linux).html">Bahasa Melayu</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/fi_FI/f3-(linux).html">Suomi</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/da_DK/f3-(linux).html">Dansk</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/uk_UA/f3-(linux).html">Українська</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/cs_CZ/f3-(linux).html">Čeština</a></li> -->
<!-- <li class="masthead__menu-item"><a href="https://3ds.hacks.guide/en_PT/f3-(linux).html">Pirate English</a></li> -->
</ul>
<button class="greedy-nav__toggle hidden" type="button">
<span class="visually-hidden">Toggle Menu</span>
<div class="navicon"></div>
</button>
<button class="greedy-nav__toggle_lang"><div class="langicon"><i class="fa fa-language fa-lg" aria-hidden="true"></i></div></button>
</nav>
</div>
</div>
</div>
<div class="initial-content">
<div id="main" role="main">
<!--
<div class="sidebar sticky">
</div>
-->
<div class="sidebar sticky" style="display: none;">
<nav class="nav__list">
<input id="ac-toc" name="accordion-toc" type="checkbox" />
<label for="ac-toc">Toggle Menu</label>
<ul class="nav__items">
<li>
<span class="nav__sub-title">Overall Progress</span>
<ol>
<li style="display: none;" data-name="home"><a href='/'>Home</a></li>
<li style="display: none;" data-name="key-information"><a href='/key-information'>Key Information</a></li>
<li style="display: none;" data-name="get-started"><a href='/get-started'>Get Started</a></li>
<li style="display: none;" data-name="ntrboot"><a href='/ntrboot'>ntrboot</a></li>
<li style="display: none;" data-name="seedminer"><a href='/seedminer'>Seedminer</a></li>
<li style="display: none;" data-name="seedminer-(twn)"><a href='/seedminer-(twn)'>Seedminer (TWN)</a></li>
<li style="display: none;" data-name="bannerbomb3"><a href='/bannerbomb3'>BannerBomb3</a></li>
<li style="display: none;" data-name="multiple-options"><i>(Multiple Options)</i></li>
<li style="display: none;" data-name="flashing-ntrboot-(3ds-single-system)"><a href='/flashing-ntrboot-(3ds-single-system)'>Flashing ntrboot (3DS Single System)</a></li>
<li style="display: none;" data-name="flashing-ntrboot-(3ds-multi-system)"><a href='/flashing-ntrboot-(3ds-multi-system)'>Flashing ntrboot (3DS Multi System)</a></li>
<li style="display: none;" data-name="flashing-ntrboot-(dsi)"><a href='/flashing-ntrboot-(dsi)'>Flashing ntrboot (DSi)</a></li>
<li style="display: none;" data-name="flashing-ntrboot-(nds)"><a href='/flashing-ntrboot-(nds)'>Flashing ntrboot (NDS)</a></li>
<li style="display: none;" data-name="homebrew-launcher-(pichaxx)"><a href='/homebrew-launcher-(pichaxx)'>Homebrew Launcher (PicHaxx)</a></li>
<li style="display: none;" data-name="bannerbomb3-fredtool-(twn)"><a href='/bannerbomb3-fredtool-(twn)'>BannerBomb3 + Fredtool (TWN)</a></li>
<li style="display: none;" data-name="installing-boot9strap-(hardmod)"><a href='/installing-boot9strap-(hardmod)'>Installing boot9strap (Hardmod)</a></li>
<li style="display: none;" data-name="installing-boot9strap-(hbl-usm)"><a href='/installing-boot9strap-(hbl-usm)'>Installing boot9strap (HBL-USM)</a></li>
<li style="display: none;" data-name="installing-boot9strap-(ntrboot)"><a href='/installing-boot9strap-(ntrboot)'>Installing boot9strap (ntrboot)</a></li>
<li style="display: none;" data-name="installing-boot9strap-(soundhax)"><a href='/installing-boot9strap-(soundhax)'>Installing boot9strap (Soundhax)</a></li>
<li style="display: none;" data-name="installing-boot9strap-(ssloth-browser)"><a href='/installing-boot9strap-(ssloth-browser)'>Installing boot9strap (SSLoth-Browser)</a></li>
<li style="display: none;" data-name="installing-boot9strap-(fredtool)"><a href='/installing-boot9strap-(fredtool)'>Installing boot9strap (Fredtool)</a></li>
<li style="display: none;" data-name="installing-boot9strap-(usm)"><a href='/installing-boot9strap-(usm)'>Installing boot9strap (USM)</a></li>
<li style="display: none;" data-name="installing-boot9strap-(kartdlphax)"><a href='/installing-boot9strap-(kartdlphax)'>Installing boot9strap (kartdlphax)</a></li>
<li style="display: none;" data-name="installing-boot9strap-(hbl-usm)"><a href='/installing-boot9strap-(hbl-usm)'>Installing boot9strap (HBL-USM)</a></li>
<li style="display: none;" data-name="finalizing-setup"><a href='/finalizing-setup'>Finalizing Setup</a></li>
</ol>
</li>
</ul>
</nav>
</div>
<article class="page" itemscope itemtype="https://schema.org/CreativeWork">
<meta itemprop="headline" content="F3 (Linux)">
<div class="page__inner-wrap">
<header>
<h1 id="page-title" class="page__title" itemprop="headline">F3 (Linux)
</h1>
</header>
<section class="page__content" itemprop="text">
<hr>
<div class ="notice"><b>For support in English, ask for help at <a href="https://discord.gg/MWxPgEp">Nintendo Homebrew on Discord</a>.</b></div>
<div class ="notice"><b>If you appreciate this guide, we accept <a href="contribute#donations">Donations</a>.</b></div>
<hr>
<aside class="sidebar__right">
<nav class="toc">
<header><h4 class="nav__title"><i class="fas fa-file-alt"></i> Table of Contents</h4></header>
<ul class="toc__menu" id="markdown-toc">
<li><a href="#required-reading" id="markdown-toc-required-reading">Required Reading</a></li>
<li><a href="#what-you-need" id="markdown-toc-what-you-need">What You Need</a></li>
<li><a href="#instructions" id="markdown-toc-instructions">Instructions</a></li>
<li><a href="#return-to-get-started" id="markdown-toc-return-to-get-started">Return to Get Started</a></li>
</ul>
</nav>
</aside>
<h3 id="required-reading">Required Reading</h3>
<p>This is an add-on section for checking your SD card for errors using F3.</p>
<p>Depending on the size of your SD card and the speed of your computer, this process can take up to several hours!</p>
<p>This page is for Linux users only. If you are not on Linux, check out the <a href="h2testw-(windows)">H2testw (Windows)</a> or <a href="f3xswift-(mac)">F3XSwift (Mac)</a> pages.</p>
<h3 id="what-you-need">What You Need</h3>
<ul>
<li>The latest version of <a href="https://github.com/AltraMayor/f3/releases/tag/v8.0">F3</a></li>
</ul>
<h3 id="instructions">Instructions</h3>
<ol>
<li>Unzip the f3 <code class="language-plaintext highlighter-rouge">.zip</code> file</li>
<li><code class="language-plaintext highlighter-rouge">cd</code> into the f3 directory</li>
<li>Run <code class="language-plaintext highlighter-rouge">make</code> to compile F3</li>
<li>Insert your SD card into your computer</li>
<li>Mount your SD card</li>
<li>Run <code class="language-plaintext highlighter-rouge">./f3write &lt;your sd card mount point&gt;</code></li>
<li>Wait until the process is complete. See below for an example output.</li>
</ol>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>./f3write /media/michel/6135-3363/
Free space: 29.71 GB
Creating file 1.h2w ... OK!
...
Creating file 30.h2w ... OK!
Free space: 0.00 Byte
Average Writing speed: 4.90 MB/s
</code></pre></div></div>
<ol>
<li>Run <code class="language-plaintext highlighter-rouge">./f3read &lt;your sd card mount point&gt;</code></li>
<li>Wait until the process is complete. See below for an example output.</li>
</ol>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>./f3read /media/michel/6135-3363/
SECTORS ok/corrupted/changed/overwritten
Validating file 1.h2w ... 2097152/ 0/ 0/ 0
...
Validating file 30.h2w ... 1491904/ 0/ 0/ 0
Data OK: 29.71 GB <span class="o">(</span>62309312 sectors<span class="o">)</span>
Data LOST: 0.00 Byte <span class="o">(</span>0 sectors<span class="o">)</span>
Corrupted: 0.00 Byte <span class="o">(</span>0 sectors<span class="o">)</span>
Slightly changed: 0.00 Byte <span class="o">(</span>0 sectors<span class="o">)</span>
Overwritten: 0.00 Byte <span class="o">(</span>0 sectors<span class="o">)</span>
Average Reading speed: 9.42 MB/s
</code></pre></div></div>
<hr />
<p class="notice--success">If the test shows the result <code class="language-plaintext highlighter-rouge">Data LOST: 0.00 Byte (0 sectors)</code>, your SD card is good and you can delete all <code class="language-plaintext highlighter-rouge">.h2w</code> files on your SD card</p>
<p class="notice--danger">If the test shows any other results, your SD card may be corrupted or damaged and you may have to replace it!</p>
<h3 class="notice--primary" id="return-to-get-started">Return to <a href="get-started">Get Started</a></h3>
</section>
<footer class="page__meta">
</footer>
</div>
</article>
</div>
</div>
<div id="footer" class="page__footer">
<footer>
<!-- start custom footer snippets -->
<!-- end custom footer snippets -->
<div class="page__footer-follow">
<ul class="social-icons">
<li><strong>Follow:</strong></li>
<li><a href="https://github.com/hacks-guide/Guide_3DS" rel="nofollow noopener noreferrer"><i class="fab fa-fw fa-github" aria-hidden="true"></i> GitHub</a></li>
<!--
<li><a href="/feed.xml"><i class="fas fa-fw fa-rss-square" aria-hidden="true"></i> Feed</a></li>
</ul>
-->
</div>
<!-- custom footer, guide specific -->
<div class="page__footer-copyright">&copy; 2023 Nintendo Homebrew. - <a href="site-navigation">Site Navigation</a> - <a href="privacy-policy">Privacy Policy</a> <!-- Powered by <a href="https://jekyllrb.com" rel="nofollow">Jekyll</a> &amp; <a href="https://mademistakes.com/work/minimal-mistakes-jekyll-theme/" rel="nofollow">Minimal Mistakes</a>.--></div>
</footer>
</div>
<script src="/assets/js/main.min.js"></script>
<!-- for guide purposes all caching is removed and is separately built. -->
</body>
</html>