macaronictl

Macaroni OS System Management Tool

The Macaroni OS knife tool to control your system.

At the moment, it contains only the commands to control the kernels and generate initrd images.

$ macaronictl --help
Copyright (c) 2020-2023 Macaroni OS - Daniele Rondina

Macaroni Linux System Management Tool

Usage:
   [command]

Available Commands:
  completion  Generate the autocompletion script for the specified shell
  env-update  Updates environment settings automatically.
  etc-update  Handle configuration file updates.
  help        Help about any command
  kernel      Manage system kernels and initrd.

Flags:
  -c, --config string   Macaronictl configuration file
  -d, --debug           Enable debug output.
  -h, --help            help for this command
  -v, --version         version for this command

Use " [command] --help" for more information about a command.

env-update

The env-update command follow the portage env-update command with same simplification.

The generation of the /etc/csh.env instead is created only when (t)csh support is enabled (with --csh option or through configuration file option).

The generation of the /etc/environment.d/10-macaroni.conf is created only when systemd support is enabled (with --systemd option or through configuration file option).

$> macaronictl env-update

$> macaronictl env-update --dry-run

$> macaronictl env-update --csh

etc-update

The etc-update command follows the Portage etc-update logic with some simplification.

It read the same /etc/etc-update.conf configuration file and it permits to use vim, emacs.

$> macaronictl etc-update

Could be used to analyze a specific path too:

$> macaronictl etc-update -p /opt/myconf

Kernel subcommands

List

Get the list of the configured and installed kernel under the /boot directory.

$> macaronictl kernel list
|  KERNEL  | KERNEL VERSION |  TYPE   | HAS INITRD | HAS KERNEL IMAGE | HAS BZIMAGE,INITRD LINKS |
|----------|----------------|---------|------------|------------------|--------------------------|
| macaroni | 5.10.162       | vanilla | true       | true             | false                    |
| macaroni | 5.15.86        | vanilla | true       | true             | false                    |
| macaroni | 5.4.228        | vanilla | true       | true             | false                    |

Available (from v0.7.0)

Get the list of the available kernel in the configured and enabled repositories:

$> macaronictl kernel available
|  KERNEL  | KERNEL VERSION | PACKAGE VERSION |    EOL    |  LTS  |  RELEASED  |  TYPE   |
|----------|----------------|-----------------|-----------|-------|------------|---------|
| macaroni | 4.14.305       | 4.14.305        | Jan, 2024 | true  | 2017-11-12 | vanilla |
| macaroni | 5.10.168       | 5.10.168        | Dec, 2026 | true  | 2020-12-13 | vanilla |
| macaroni | 5.15.94        | 5.15.94         | Oct, 2026 | true  | 2021-10-31 | vanilla |
| macaroni | 5.4.231        | 5.4.231         | Dec, 2025 | true  | 2019-11-24 | vanilla |
| macaroni | 6.1.12         | 6.1.12          | Dec, 2026 | true  | 2022-12-11 | vanilla |
| macaroni | 6.2.1          | 6.2.1           | N/A       | false | 2023-02-19 | vanilla |

or only the LTS kernels:

$> macaronictl kernel available --lts
|  KERNEL  | KERNEL VERSION | PACKAGE VERSION |    EOL    | LTS  |  RELEASED  |  TYPE   |
|----------|----------------|-----------------|-----------|------|------------|---------|
| macaroni | 4.14.305       | 4.14.305        | Jan, 2024 | true | 2017-11-12 | vanilla |
| macaroni | 5.10.168       | 5.10.168        | Dec, 2026 | true | 2020-12-13 | vanilla |
| macaroni | 5.15.94        | 5.15.94         | Oct, 2026 | true | 2021-10-31 | vanilla |
| macaroni | 5.4.231        | 5.4.231         | Dec, 2025 | true | 2019-11-24 | vanilla |
| macaroni | 6.1.12         | 6.1.12          | Dec, 2026 | true | 2022-12-11 | vanilla |

Generate Initrd

$> macaronictl kernel gi --help
Rebuild Dracut initrd images.

$> # Generate all initrd images of the kernels available on boot dir.
$> macaronictl kernel geninitrd --all

$> # Generate all initrd images of the kernels available on boot dir
$> # and set the bzImage, Initrd links to one of the kernel available
$> # if not present or to the next release of the same kernel after the
$> # upgrade.
$> macaronictl kernel geninitrd --all --set-links

$> # Generate all initrd images of the kernels available on boot dir
$> # and set the bzImage, Initrd links to one of the kernel available
$> # if not present or to the next release of the same kernel after the
$> # upgrade. In addition, it purges old initrd images and update grub.cfg.
$> macaronictl kernel geninitrd --all --set-links --purge --grub

$> # Just show what dracut commands will be executed for every initrd images.
$> macaronictl kernel geninitrd --all --dry-run

$> # Generate the initrd image for the kernel 5.10.42
$> macaronictl kernel geninitrd --version 5.10.42

$> # Generate the initrd image for the kernel 5.10.42 and kernel type vanilla.
$> macaronictl kernel geninitrd --version 5.10.42 --ktype vanilla

$> # Generate the initrd image for the kernel 5.10.42 and kernel type vanilla
$> # and set the links bzImage, Initrd to the selected kernel/initrd.
$> macaronictl kernel geninitrd --version 5.10.42 --ktype vanilla

Usage:
   kernel geninitrd [flags]

Aliases:
  geninitrd, gi

Flags:
      --all                          Rebuild all images with kernel.
      --bootdir string               Directory where analyze kernel files. (default "/boot")
      --dracut-opts string           Override the default dracut options used on the initrd image generation.
                                     Set the MACARONICTL_DRACUT_ARGS env in alternative.
      --dry-run                      Dry run commands.
      --grub                         Update grub.cfg.
  -h, --help                         help for geninitrd
      --kernel-profiles-dir string   Specify the directory where read the kernel types profiles supported. (default "/etc/macaroni/kernels-profiles/")
      --ktype string                 Specify the kernel type of the initrd image to build.
      --purge                        Clean orphan initrd images without kernel.
      --set-links                    Set bzImage and Initrd links for the selected kernel or update links of the upgraded kernel.
      --version string               Specify the kernel version of the initrd image to build.

Global Flags:
  -c, --config string   MacaroniCtl configuration file
  -d, --debug           Enable debug output.

Browser subcommands (from v0.9.0)

In order to configure default startup options of the available browsers, macaronictl supplies commands to create a script wrapper with default options to use, options that could be customized by the user with the same tool.

At the moment the supported browsers are Brave and Google Chrome.

This needs is started with the upgrade of Chromium engine 117.x where the default flags are related to the 3d acceleration, this breaks old computers with poor cards. We prefer to support solutions with poor hardware by default.

$> macaronictl browser --help
Manage browsers binaries and their default bootstrap options.

Usage:
   browser [command]

Aliases:
  browser, b

Available Commands:
  available   List available browsers and their customization.
  configure   Configure bootstrap options of a specific browser.

Flags:
  -h, --help   help for browser

Global Flags:
  -c, --config string   Macaronictl configuration file
  -d, --debug           Enable debug output.

Use " browser [command] --help" for more information about a command.

available

The available command show the list of available browsers and if it's present a system configuration and/or a user customization of the startup flags.

$  macaronictl  browser available
|              PACKAGE              | PACKAGE VERSION | SYSTEM OPTIONS | USER OPTIONS |  ENGINE  |            BINARIES             |
|-----------------------------------|-----------------|----------------|--------------|----------|---------------------------------|
| www-client/brave-bin              | v1.59.117       | true           | true         | chromium | /usr/bin/brave-bin              |
| www-client/firefox                | v118.0.2        | false          | false        | N/A      | N/A                             |
| www-client/firefox-beta-bin       | v119.0          | false          | false        | N/A      | N/A                             |
| www-client/firefox-bin            | v118.0.2        | false          | false        | N/A      | N/A                             |
| www-client/google-chrome          | v118.0.5993.70  | false          | false        | chromium | /usr/bin/google-chrome-stable   |
| www-client/google-chrome-beta     | v119.0.6045.21  | false          | false        | chromium | /usr/bin/google-chrome-beta     |
| www-client/google-chrome-unstable | v120.0.6062.2   | false          | false        | chromium | /usr/bin/google-chrome-unstable |
| www-client/opera                  | v99.0.4788.9+1  | false          | false        | N/A      | N/A                             |
| www-client/vivaldi                | v6.2.3105.58    | false          | false        | N/A      | N/A                             |
| www-client/vivaldi-snapshot       | v6.4.3152.3     | false          | false        | N/A      | N/A                             |

configure

The configure supply a way to setup the browser wrapper script used to start the binaries and configure the startup flags at system level or at user level.

$> macaronictl  browser conf --help
Shows browsers available in configured repositories.

# Generate the system yaml file with the default options from catalog.
$> macaronictl browser conf www-client/brave-bin --system --defaults

# Generate the user yaml file with the default options from catalog.
$> macaronictl browser conf www-client/brave-bin --user --defaults

# Generate the user yaml file without options for the selected package.
$> macaronictl browser conf www-client/brave-bin --user --without-opts

# Generate the user yaml file awithout options and the user include file
# for the selected package.
$> macaronictl browser conf www-client/brave-bin --user --without-opts --exec

# Generate the binary script of the package and the system includes scripts.
# Normally, this command is executed on package finalizer.
$> macaronictl browser conf www-client/brave-bin --exec --system  --defaults

# Generate the user include and YAML files with the default options
$> macaronictl browser conf www-client/brave-bin --exec --user  --defaults

# Remove the user include file.
$> macaronictl browser conf www-client/brave-bin --purge --user

# Remove the sytem include file and the binary of the package
$> macaronictl browser conf www-client/brave-bin --purge --system

# Update the user include file. Normally, used when the user YAML file
# is been modified manually.
$> macaronictl browser conf www-client/brave-bin --user --only-update-includes

# Update the system include file. Normally, used when the user YAML file
# is been modified manually.
$> macaronictl browser conf www-client/brave-bin --system --only-update-includes

NOTE: It works only if the repositories are synced.

Usage:
   browser configure [pkg] [flags]

Aliases:
  configure, conf, c

Flags:
      --catalog-file string    Specify the directory of the catalog file of all engines options. (default "/usr/share/macaroni/browsers/catalog")
      --defaults               Set catalog defaults options to specified package.
      --exec                   Update script of the binary. Need root permissions.
  -h, --help                   help for configure
      --home-dir string        Override the directory of the user with engines options. (default "/home/geaaru/.local/share/macaroni/browsers")
      --only-update-includes   Update script includes file.
      --purge                  Remove system option from system. Need root permissions.
      --system                 Set bootstrap option on system. Need root permissions.
      --system-dir string      Override the directory of the system configuration with engines options. (default "/etc/macaroni/browsers")
      --user                   Set bootstrap option for user.
      --without-opts           Disable all options to specified package.

Global Flags:
  -c, --config string   Macaronictl configuration file
  -d, --debug           Enable debug output.