patches and low-level development discussion
 help / color / mirror / code / Atom feed
blob e3db767a2d8bba1edafdbe7805879457b2894823 812 bytes (raw)
name: Documentation/doc/development/persistent-storage.adoc 	 # note: path name is non-authoritative(*)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
 
= Persistent storage
:page-nav_order: 2

// SPDX-FileCopyrightText: 2024-2025 Alyssa Ross <hi@alyssa.is>
// SPDX-License-Identifier: GFDL-1.3-no-invariants-or-later OR CC-BY-SA-4.0

Spectrum's root filesystem is immutable, so if you want to be able to
persist data between sessions, you'll need to create a persistent
storage partition.  Spectrum comes with `cryptsetup`, and in future is
likely to assume that btrfs-specific features are available.

Persistent storage can be mounted as follows:

[source,shell]
----
cryptsetup open /dev/sda1 userdata
mount-userdata /dev/mapper/userdata
----

It's not mounted automatically, because generally the partition should
be encrypted, meaning a key has to be supplied to mount it anyway, and
because there might be multiple persistent data partitions to choose
from.

debug log:

solving e3db767 ...
found e3db767 in https://spectrum-os.org/git/spectrum

(*) Git path names are given by the tree(s) the blob belongs to.
    Blobs themselves have no identifier aside from the hash of its contents.^

Code repositories for project(s) associated with this public inbox

	https://spectrum-os.org/git/doc
	https://spectrum-os.org/git/mktuntap
	https://spectrum-os.org/git/spectrum
	https://spectrum-os.org/git/ucspi-vsock

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).