documentation update for release

long due, was ready in november 2022 and basically left unchanged at
that stage, except the deprecation of veracrypt in the experimental
portable branch, which is not included in the stable release.
This commit is contained in:
Jaromil 2023-09-18 16:04:19 +02:00
parent 58035cf14a
commit 51452e4e6a
5 changed files with 34 additions and 40 deletions

View File

@ -8,21 +8,22 @@ Tomb includes code and advices by Anathema, Boyska, Hellekin O. Wolf,
Daniel Rodriguez, Parazyd, Alexandre Pujol, AitorATuin, Narrat, Artur
Malimonov and Chris Vogel.
The 'gtomb' GUI based on Zenity is written by Parazyd.
The 'gtomb' GUI based on Zenity is written by Parazyd and Daniel Dias Rodrigues.
The Qt5 desktop tray GUI is written by Gianluca Montecchi.
Python Tomb wrappers are contributed by Reiven and Boyska.
The Docker Tomb wrapper is contributed by Greg Tczap
The Docker Tomb wrapper is contributed by Greg Tczap and Jens Rischbieth.
Artwork is contributed by Jordi aka Mon Mort and Logan VanCuren.
Gettext internationalization and Spanish translation is contributed by
Daniel Rodriguez. French translation by Hellekin and Roy Lockhart,
Russian translation by fsLeg, German translation by Jerry Polfer,
Italian translation by Massimiliano Augello and Swedish translation by
PLJ / Kosovoper.
Daniel Rodriguez and Francisco Serrador. French translation by
Hellekin and Roy Lockhart, Russian translation by fsLeg and AHOHNMYC,
German translation by Jerry Polfer, Italian translation by
Massimiliano Augello and Swedish translation by PLJ / Kosovoper,
general fixes contributed by Daniel Dias Rodrigues.
Testing, reviews and documentation contributed by Dreamer, Vlax,
Shining the Translucent, Mancausoft, Asbesto Molesto, Nignux, TheJH,
@ -31,8 +32,8 @@ Polfer, Jim Turner, Maxime Arthaud, RobertMX, mhogomchungu Mandeep
Bhutani, Emil Lundberg, Joel Montes de Oca, Armin Mesbah, Arusekk,
Stephan Schindel, Asbjørn Apeland, Victor Calvert, bjonnh, SargoDevel,
AitorATuin, Alexis Danizan, Sven Geuer, Greg Tczap, Aaron Janse, Mark
Mykkanen, Alexis Danizan, Steve Litt, James R, Matthieu Crapet and...
the Linux Action Show!
Mykkanen, Alexis Danizan, Steve Litt, James R, Matthieu Crapet, Selene
ToyKeeper, Valentin Heidelberg and... the Linux Action Show!
Tomb includes an implementation of the "Password-Based Key Derivation
Function v2" based on GCrypt and written by Anthony Thyssen, with

View File

@ -1,19 +1,13 @@
# Tomb ChangeLog
## 3.0
### Nov 2022
## 2.10
### Sep 2023
This release adds optional support for Argon2 KDF brute-force
protection and introduces support for doas as an alternative to sudo
for privilege escalation. It also improves support for BTRFS
formatted Tombs, adds zram detection as swap memory, updates
documentation and translations and cleans up the script code. There
are no major changes nor bug fixes compared to the previous Tomb
version: the major version increase signals the beginning of a new
development course that goes beyond Linux Tomb and adds Portable Tomb
(WIP) as an alternative and more portable POSIX shell script using
Veracrypt for volume encryption.
for privilege escalation. It also improves support for BTRFS formatted
Tombs, adds zram detection as swap memory, updates documentation and
translations and cleans up the script code.
## 2.9
### Jan 2021

View File

@ -26,7 +26,7 @@ For the instructions on how to get started using Tomb, see [INSTALL](INSTALL.md)
![tomb's logo](https://github.com/dyne/Tomb/blob/master/extras/images/monmort.png)
[![Build Status](https://github.com/dyne/tomb/actions/workflows/linux.yml/badge.svg)](https://github.com/dyne/Tomb/actions)
[![Build Status](https://github.com/dyne/tomb/actions/workflows/portable.yml/badge.svg)](https://github.com/dyne/Tomb/actions)
<!-- [![Build Status](https://github.com/dyne/tomb/actions/workflows/portable.yml/badge.svg)](https://github.com/dyne/Tomb/actions) -->
# What is Tomb, the crypto undertaker?
@ -45,9 +45,6 @@ standard filesystem tools (GNU) and the cryptographic API of the Linux
kernel (cryptsetup and LUKS). It can also produce machine parsable
output to facilitate its use inside graphical applications.
Starting with the 3.0 release path, also a new [Portable Tomb](portable) script
is made available (under development) which works on more operating systems beyond Linux based, is written in POSIX shell, has less dependencies and features and is based on [Veracrypt](https://www.veracrypt.fr) instead of LUKS/cryptsetup.
# How does it work?
To create a Tomb, do:
@ -196,10 +193,9 @@ equivalent standards supported by the Linux kernel.
Tomb can be used in conjunction with some other software applications,
some are developed by Dyne.org, but some also by third parties.
It works well inside the Windows Subsystem for Linux starting from the
Windows 11 release since that supports mounting loopback volumes.
Portable Tomb extends support to Apple/OSX systems and FreeBSD.
It works well inside the Windows Subsystem for Linux (WSL2) starting
from the Windows 11 release since that supports mounting loopback
volumes.
### Included extra applications
@ -293,8 +289,8 @@ coding style are illustrated in [doc/HACKING.txt](doc/HACKING.txt).
# Licensing
Tomb is Copyright (C) 2007-2022 by the Dyne.org Foundation and
maintained by [Jaromil](/jaromil). More information on all
Tomb is Copyright (C) 2007-2023 by the Dyne.org Foundation and
maintained by [Jaromil](https://github.com/jaromil). More information on all
the developers involved is found in the [AUTHORS](AUTHORS.md) file.
This source code is free software; you can redistribute it and/or

View File

@ -1,11 +1,11 @@
# Portable Tomb :: the crypto undertaker runs everywhere
[![continuous integration tests badge](https://github.com/dyne/tomb/actions/workflows/portable.yml/badge.svg)](https://github.com/dyne/Tomb/actions) test coverage status for portability between Ubuntu-20 and FreeBSD-13.
[![continuous integration tests badge](https://github.com/dyne/tomb/actions/workflows/portable.yml/badge.svg)](https://github.com/dyne/Tomb/actions) test coverage status for portability
## ⚠️ WORK IN PROGRESS 🛠️
This is the portable version of [Tomb](https://github.com/dyne/tomb) using [Veracrypt](https://www.veracrypt.fr) in place of cryptsetup.
This is the portable version of [Tomb](https://github.com/dyne/tomb)
[![software by Dyne.org](https://files.dyne.org/software_by_dyne.png)](http://www.dyne.org)
@ -13,12 +13,15 @@ This is the portable version of [Tomb](https://github.com/dyne/tomb) using [Vera
Portable tomb achieves direct **interoperable access to tomb volumes** between:
- GNU and Busybox Linux
- MS/Windows using WSL2
- Apple/OSX using [MacFUSE](https://osxfuse.github.io/)
- FreeBSD
- GNU base Linux (Ubuntu)
- Busybox based Linux (Alpine)
- MS/Windows using WSL2 (Ubuntu)
- FreeBSD (WIP using libluksde)
- ~~Apple/OSX using [MacFUSE](https://osxfuse.github.io/)~~
Portable tomb reduces dependencies and in particular uses only the **POSIX sh interpreter**.
After some extensive testing during 2022, __adoption of Veracrypt in portable Tomb has been dropped__ because of unreliability and bad performance.
Portable tomb stays as an experimental branch that aims to reduce dependencies and in particular uses only the **POSIX sh interpreter**.
# Status
@ -36,7 +39,7 @@ The following features will be implemented where possible:
## Dependencies
- FreeBSD: `fusefs-libs3 fusefs-lkl e2fsprogs util-linux`
- FreeBSD: `fusefs-libs3 fusefs-lkl e2fsprogs util-linux libluksde`
- Linux: `fuse3 util-linux`
- crossplatform [Veracrypt binaries](https://files.dyne.org/tomb3/third-party) console-only
@ -48,7 +51,7 @@ I setup [my own build](https://github.com/jaromil/veracrypt) and provide binary
# Disclaimer
Tomb is Copyright (C) 2007-2022 by the Dyne.org Foundation and
Tomb is Copyright (C) 2007-2023 by the Dyne.org Foundation and
developed by [Jaromil](https://github.com/jaromil).
This source code is free software; you can redistribute it and/or

4
tomb
View File

@ -7,7 +7,7 @@
# {{{ License
# Copyright (C) 2007-2022 Dyne.org Foundation
# Copyright (C) 2007-2023 Dyne.org Foundation
#
# Tomb is designed, written and maintained by Denis Roio <jaromil@dyne.org>
#
@ -31,7 +31,7 @@
# {{{ Global variables
typeset VERSION="2.10.0"
typeset DATE="Feb/2022"
typeset DATE="Sep/2023"
typeset TOMBEXEC=$0
typeset TMPDIR=${${TMPPREFIX%/*}:-/tmp}
# TODO: configure which tmp dir to use from a cli flag