~ Return to the rest of the site

software

updated 2022-05-26


Foreword

Due to the majority of designers having typical ability, use of computers may be significantly more challenging for users with disabilities, especially affecting sight and reading. Change in this regard for those that simply lack the facilities to read but have the patience to do so is inevitable but slow, with current measures being proprietary (designed first to make money and second for function) or sorely lacking in actual useability. Helping users with a deeper inability to read extensively is a tougher problem to which the solution may not yet be known even vaguely. The only advice I can offer is that everyone should, until the point at which it harms others, see to the removal of obstacles to their ability, without hesitation or apology. If you give up on computing, so be it. There are more valuable things to explore in life.

Computers encase lightning within sand with the purpose of creating a lifelike inanimate robot that can consider particularly boring thought. Measures should be taken to avoid attachment, whether mental, emotional, or physical, to computers. Caution can accompany admiration. Ultimately, the humans were the ones that produced the computers, and computers amplify human flaws as well as human feats. Try to be kind to everyone but don't take anything too seriously.

ACPI client

An ACPI client is a program that displays computer ACPI information, typically power and thermal statuses. The usual text program used is acpi(1).

Alpine

Always install manual pages

Alpine doesn't include man pages in program packages to save on space, instead keeping them in [package]-doc sibling packages. To always install doc packages with program packages, apk add docs.

postmarketOS

postmarketOS is an Alpine-based Linux software distribution that makes configuring and using Linux easy on mobile devices.

Random MAC address generation on Wifi

By default, postmarketOS will generate a random software MAC address when connecting to a new WLAN network. You can disable this by adding a NetworkManager rule. In /etc/NetworkManager/conf.d/ you can make a file with any name that has the following:


[device]
wifi.scan-rand-mac-address=no

On a live system you can then rc-service networkmanager restart to restart NetworkManager and have it load the new configuration.

Arch and Artix

Bootstrapping: Installing essential packages

On Artix, use basestrap(8). On Arch, use pacstrap(8).

At a minimum you need base on both Arch and Artix. On Artix, you need to select the initialization you want to use: 66, dinit, openrc, runit, or s6-base. On both Arch and Artix, select a kernel; linux, linux-lts, or another Linux configuration or fork. Arch says you need to install linux-firmware, technically you don't need to do so but you should. Artix says you need to install the appropriate elogind package (elogind-$(INIT_SYSTEM); e.g. elogind-66). This isn't necessary if you aren't using elogind, but you most likely want elogind. Install base-devel if you plan on using the AUR or if you don't know what the AUR is yet.

It's also a good idea to install any utilities you'll need on the bootstrapped system. Text editors, network managers or utilities, and other administration tools, for example. Manual utilities such as man-db and others would also be useful.

Ubiquitous packages missing

From the anals of my notes, 2021-06-04:

Had an issue with pacman missing some ubiquitous packages (esr's `ascii`, xorg-xev, etc).
This fixed it. I don't really know why - maybe some issues with my repos?
This was cleanly installed artix-openrc.

[5:46 PM] Bassman Leyla: So what I did is I went into /etc/pacman.d/mirrorlist-arch and uncommented a local mirror
[5:46 PM] Bassman Leyla: Then I appended a config block a package maintainer gave me onto /etc/pacman.conf
[5:46 PM] Bassman Leyla: I'll paste it in
[5:47 PM] Bassman Leyla:
```
#
# ARCHLINUX
#

#[testing]
#Include = /etc/pacman.d/mirrorlist-arch

[extra]
Include = /etc/pacman.d/mirrorlist-arch

#[community-testing]
#Include = /etc/pacman.d/mirrorlist-arch

[community]
Include = /etc/pacman.d/mirrorlist-arch

#[multilib-testing]
#Include = /etc/pacman.d/mirrorlist-arch

#[multilib]
#Include = /etc/pacman.d/mirrorlist-arch
```

C Language

For compilation, tcc(1), gcc(1), and clang(1) are all reasonable choices depending on your needs.

On Alpine Linux, the standard library headers are in the musl-dev package.

In most system package managers, standard library documentation can be found in the man-pages and man-pages-posix packages.

Many Linux software distributions' system package managers have meta-packages that pull all necessities for C development as dependencies. Alpine has build-base and Debian has build-essential.

Debian

Debian is a Linux software distribution known for its stability and longevity. Debian uses SystemD as its initialization system, the GNU core utilities, and dpkg and apt for package management.

Ubuntu

echo(1)

Don't use echo(1), use printf(1). printf(1) simulates the printf(3) function in the C standard I/O library which has no significant variations, whereas the functionality of echo(1) can vary between vendors. The following sh(1) program provides echo(1) through printf(1):

#!/bin/sh
printf "%s" "$*"

Fonts

fstab

See fstab(5).

postmarketOS requires that the localmount OpenRC service be enabled for the system to read fstab(5).

Arch and Artix have fstab generators at genfstab(8) and fstabgen(8) respectively in their installation scripts.

Linux

Culture

Pronunciation

Xenia

Xenia was an entry for the Linux logo competition which Tux eventually won.

Login manager

Use elogind.

Make utility

make(1) in modern times is fragmented into the GNU version (in context, gmake) and the {Free,Open,Net}BSD version (bmake). Complex Makefiles may not be useable in both. It's custom for Linux systems to have make(1) as GNU Make and bmake(1) as BSD Make, and BSD-based systems to have make(1) as BSD Make and gmake(1) as GNU Make.

On-line manual

In the context of POSIX and UNIX-like systems, an "on-line" manual is a manual that is accessible via the computer system it documents. Particularly, the man(1) utility and the manual "pages" it references.

Alpine by default uses mandoc.

Paging

less(1) is more(1); more or less.

Partitions and filesystems

Don't use partitioners included with OS media where the same job can be done by GParted (which has live media available) or another good general-purpose partitioner. BSDs and Plan 9 are exceptions to this rule due to their exotic partitioning systems. Using utilities from a shell or TUIs does not make you "cooler" than someone who needs a GUI for partitioning; in some cases, messing up partitioning can have serious consequences, so it's always nice to have some idiot-proofing. I always partition my disks with the GParted live media.

You should do your own research on how you should partition your disks. I personally use separate partitions for /boot, /home, /, and swap. Your needs will vary.

Please note that a separate boot partition is mandatory if you intend to boot via (U)EFI. Check out the linked pages in the "See also" section.

Use mkfs(8) for creating filesystems and mount(8) for mounting partitions' filesystems.

gpart

Available as sysutils/gpart in pkgsrc.

gpart(8) is a tool that scans a file (or block device presented as a file) for drive partitions regardless of any table present on the medium.

LUKS

e2fsprogs is needed for the dm_mod kernel module used for LUKS partition decryption.

To format a partition to a LUKS volume, determine the physical block device location for that partition and run cryptsetup luksFormat [partition]. The passphrase used can be changed or removed after creation.

To open a LUKS volume, use cryptsetup luksOpen [partition] [name]. This name is the name the decrypted block device location will take in /dev/mapper/.

Before the decrypted block device has a filesystem it'll just be cleared space - format as normal but use the decrypted block device location.

To mount a partition in an opened LUKS volume, use mount(8) as normal, just with the decrypted block device location.

To close an open LUKS volume, umount(8) any mapped and mounted partitions from the volume and cryptsetup luksClose [name].

To make the LUKS partition openable via keyfile, first make a keyfile (dd if=/dev/urandom of=/root/keyfile bs=1024 count=4 seems to work), and optionally make it readable by root only (chmod 0400 [keyfile]). Then add the keyfile to the partition's LUKS header with cryptsetup luksAddKey [physical partition block device] [keyfile].

dm-crypt

dm-crypt is a service that automatically mounts LUKS volumes at boot.

On most OpenRC-initialized distributions, the cryptsetup-openrc package provides dmcrypt. Make sure that service is added to runlevel boot.

Configuration is in /etc/conf.d/dmcrypt and further configuration should be done in fstab. dm-crypt will need the UUID of the physical block device while fstab (if being configured with UUIDs will need the UUID of the decrypted block device in the device mapper.

PCI Utilities

Available as sysutils/pciutils from pkgsrc. Supplies lspci(8), setpci(8), and update-pciids(8).

update-pciids(8) is not part of the pciutils package in Alpine Linux repositories.

NetBSD

Battery

envstat(1) can show the current battery status.

Mounting ext4 partitions with FUSE

  1. Install filesystems/fuse and filesystems/fuse-ext2.
  2. Connect the drive with the ext4 partition you want to access.
  3. Use dmesg(8) to determine the location in /dev/ of the disk.
  4. Use disklabel(8) to determine which partition on the disk you want to access (disklabel /dev/disk) - it will be listed with the partition type "Linux Ext2" even though the partition may be ext4.
  5. Use fuse-ext2(1) to mount the partition (fuse-ext2 /dev/disk with partition letter mountpoint - for example, fuse-ext2 /dev/sd1e /mnt/sd1 to mount partition e of device sd1 to the mountpoint /mnt/sd1).
  6. This mountpoint can be unmounted with umount(8) as normal.

Fix SSL certificate problem: unable to get local issuer certificate

Install security/mozilla-rootcerts-openssl.

Do not use SSL workarounds like (in the case of git) GIT_SSL_NO_VERIFY. These leave your system open to man-in-the-middle attacks.

System logging

See syslogd(8) and syslog.conf(5), which pertain to system logging.

Setting DDB_ONPANIC (see options(4) and sysctl(8)) will save a crash dump at /var/crash on kernel panic.

Power

Much of this can be configured in the ACPI settings in your login manager, provided you have one running that can do this.

Check out tlp for Thinkpads and some other Lenovo devices.

SSH keys

SSH keys are typically stored in $HOME/.ssh.

Typically, the public key's filename will be suffixed with .pub, while the private key will not.

You can generate an SSH key with ssh-keygen(1). Currently the preferred implementation is openssh-keygen, part of the OpenSSH suite.

Microsoft GitHub documentation suggests a user create a key with ssh-keygen -t ed25519 -C "[e-mail address]". This generates an Ed25519 SSH key with an e-mail address in the key comment.

Task management

top(1) comes with busybox, otherwise use htop.

Text editing

nano(1) is a text editor that's usually recommended for beginners because its controls are more intuitive. ne(1) is like nano(1) but with different superpowers. Not yet in pkgsrc.

ed

A particularly shoddy attempt at ed(1) is provided by busybox. A traditional ed(1) implementation is in plan9ports. I'm pretty sure some later UNIX-based OSes doubled the ed(1) buffers, there's pretty much no downside to doing so in the modern era but it should be very easy to do yourself if it hasn't already been done (just double some of the array sizes in the beginning of ed.c).

vi

Unlike busybox's ed(1) implementation, its vi(1) is very useable. vim(1) is a popular re-implementation of vi(1).

emacs

Emacs ("editor macros") is a text editor with a very powerful Lisp interpreter included. Lisp is mostly antiquated due to its undeserved lack of popularity. Linus Torvalds uses his own fork of uEmacs ("micro Emacs"), an Emacs without the Lisp interpreter(?).

cat

Technically cat(1) and other UNIX utilities can be used in a hacky way for text editing functions. You'd be better off using ed(1); the UX is very similar.

util-linux

util-linux is distributed on all popular Linux distributions and contains utilities users may expect to be already present on their systems, like more(1) or hexdump(1).

WiFi

wpa_supplicant

wpa_supplicant(1) is usually good enough for establishing WiFi connections.

Here's an example configuration for a simple WPA-2 PSK access point.

network={
	ssid="My SSID"
	key_mgmt=WPA-PSK
	scan_ssid=1
	psk="My password"
}

See wpa_supplicant.conf(5).

X

X is a graphical windowing system that can be used on Linux, FreeBSD, OpenBSD, NetBSD, and some proprietary operating systems as well. X is not the only windowing system; twin(1) exists for windowed multitasking within a framebuffer and Wayland is another windowing system intended to replace X.

Xorg requires the user to be a member of the input and video groups (or superuser), otherwise it won't be able to access the relevent device files. These errors look like Failed to open /dev/input/event[number] (Permission denied) when not in the input group and Failed to open /dev/tty[number] (Permission denied) when not in the video group.

Some Linux software distributions have included scripts to automatically fetch and install an X server. Alpine has setup-xorg-base, which adds the packages xorg-server, xf86-input-libinput, eudev, and mesa, and then enables the OpenRC services for udev.

startx(1) is provided as part of xinit.

Arch has the xorg and xorg-apps package groups. Documentation can be found within xorg-docs, drivers within the xorg-drivers package group, the server itself as xorg-server, the X event monitor as xorg-xev, xinit as xorg-xinit, xinput as xorg-xinput, XRandR as xorg-xrandr, the X resource database manager as xorg-xrdb, xset as xorg-xset, and xsetroot as xorg-xsetroot.

Alpine has xinput as xinput.

Audio

Most audio servers recommend that they be run in userspace with user privileges, with PulseAudio going so far as to exiting when run as root without additional configuration. The Alpine wiki currently recommends pipewire(1), with postmarketOS, which is based on Alpine, coming pre-configured with PipeWire. PipeWire is relatively new and the typical audio server used is PulseAudio; Debian and many popular Debian-based distributions come pre-configured with PulseAudio.

ALSA

The Alpine wiki ("Adding sound") says to install alsa-conf, alsa-lib, and alsa-utils, add yourself to the audio group, and then do some more configuration that I've never needed to do: Use alsamixer(1) to find a working sound card (press F6 from the first screen ALSAMixer presents) and edit /usr/share/alsa/alsa.conf and change defaults.ctl.card and defaults.pcm.card to the sound card that works.

The Alpine wiki doesn't mention this but you'll need to enable the alsa OpenRC service and either start it or reboot. I also installed gstreamer but I don't know why.

ALSA is clunky, many people prefer to use a frontend such as Pipewire or PulseAudio that exposes its own interface while remaining compatible with ALSA.

OSS

Deprecated, unfortunately.

PipeWire

Provided by the pipewire package on Alpine.

RTKit error: org.freedesktop.DBus.Error.ServiceUnknown

This means you need rtkit installed and running through your initialization system.

PulseAudio

On Alpine you'll need the pulseaudio, pulseaudio-alsa, and alsa-plugins-pulse packages for PulseAudio with ALSA compatibility. Start pulseaudio(1) when you want audio, ideally in your .xinitrc.

Media

mpv(1) and vlc(1) are good options.

Window Management

It's possible to make X exec a window manager at the end of initialization to ease the creation, deletion, and manipulation of windows. Contrary to what is now popular belief, window managers are not necessary (thought they're extremely convenient compared to the lack of them).

ctwm

Web Browsing

TOR Browser

TOR Browser is available through pkgsrc at security/tor-browser.