pacman-debian 7.3.10 → 7.3.13

package/dist/types.d.ts

@@ -0,0 +1,80 @@
+export interface DebControl {
+    package: string;
+    version: string;
+    architecture: string;
+    maintainer?: string;
+    description?: string;
+    depends?: string;
+    'pre-depends'?: string;
+    'recommends'?: string;
+    'suggests'?: string;
+    conflicts?: string;
+    breaks?: string;
+    provides?: string;
+    'installed-size'?: string;
+    section?: string;
+    priority?: string;
+    homepage?: string;
+    [key: string]: string | undefined;
+}
+export interface DebPackage {
+    path: string;
+    control: DebControl;
+    controlTar: Buffer;
+    dataTar: Buffer;
+}
+export interface InstalledPackage {
+    name: string;
+    version: string;
+    architecture: string;
+    description: string;
+    depends?: string;
+    'pre-depends'?: string;
+    conflicts?: string;
+    provides?: string;
+    maintainer?: string;
+    homepage?: string;
+    controlSection?: string;
+    controlPriority?: string;
+    installedSize?: number;
+    installTime: number;
+    reason: 'explicit' | 'dependency';
+    files: string[];
+}
+export interface RepoPkg {
+    package: string;
+    version: string;
+    architecture: string;
+    description?: string;
+    depends?: string;
+    'pre-depends'?: string;
+    conflicts?: string;
+    provides?: string;
+    filename: string;
+    size?: number;
+    sha256?: string;
+    repo: string;
+}
+export interface RepoConfig {
+    name: string;
+    server: string;
+    dist: string;
+    components: string[];
+}
+export interface Config {
+    architecture: string;
+    repos: RepoConfig[];
+}
+export interface Database {
+    packages: Map<string, InstalledPackage>;
+    fileIndex: Map<string, string>;
+}
+export interface Transaction {
+    id: string;
+    timestamp: number;
+    action: 'install' | 'remove';
+    package: string;
+    version: string;
+    completed: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/ui/colors.d.ts

@@ -0,0 +1,13 @@
+export declare const color: {
+    repo: (s: string) => string;
+    pkg: (s: string) => string;
+    local: (s: string) => string;
+    error: (s: string) => string;
+    warn: (s: string) => string;
+    ok: (s: string) => string;
+    muted: (s: string) => string;
+    title: (s: string) => string;
+    size: (s: string) => string;
+    rate: (s: string) => string;
+};
+//# sourceMappingURL=colors.d.ts.map

package/dist/ui/format.d.ts

@@ -0,0 +1,3 @@
+export declare function formatBytes(n: number): string;
+export declare function pkgLabel(name: string, version: string): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/ui/progress.d.ts

@@ -0,0 +1,8 @@
+export declare function humanSize(n: number, dec: number): {
+    val: string;
+    unit: string;
+};
+export declare function drawProgressBar(pct: number, cols: number): string;
+export declare function formatRate(rate: number): string;
+export declare function formatETA(eta: number): string;
+//# sourceMappingURL=progress.d.ts.map

package/dist/ui/prompt.d.ts

@@ -0,0 +1,4 @@
+export declare let noconfirm: boolean;
+export declare function setNoConfirm(val: boolean): void;
+export declare function confirm(prompt: string, defaultYes?: boolean): Promise<boolean>;
+//# sourceMappingURL=prompt.d.ts.map

package/docs/en/architecture.md

@@ -0,0 +1,188 @@
+# Architecture
+
+## Source Tree
+
+```
+src/
+├── cli/
+│   ├── pacman.ts            # CLI argument parsing and dispatch
+│   ├── paclink.ts           # Virtual package link management
+│   ├── update-ca-trust.ts   # Arch-compat CA certificate updater
+│   ├── archlinux-java.ts    # Arch-compat Java alternatives manager
+│   └── fix_default.ts       # Arch-compat default JDK helper
+├── core/                    # Package format parsers, dependency engine
+│   ├── ar.ts                # ar archive parser
+│   ├── tar.ts               # tar extractor
+│   ├── deb.ts               # .deb package parser
+│   ├── pkgfile.ts           # .pkg.tar.zst parser
+│   ├── compress.ts          # gz/xz decompression
+│   ├── control.ts           # debian control file parser
+│   └── deps.ts              # Dependency resolution engine
+├── db/
+│   ├── localdb.ts           # Directory-based local package DB
+│   ├── database.ts          # DB wrapper with transactions
+│   └── dpkg-compat.ts       # dpkg status file read/write
+├── ops/
+│   ├── install.ts           # Package installation
+│   ├── remove.ts            # Package removal
+│   ├── query.ts             # All -Q queries
+│   └── upgrade.ts           # Sync + upgrade flow
+├── repo/
+│   ├── repository.ts        # Repo sync, download, JSONL cache
+│   └── config.ts            # pacman.conf parser with Include support
+├── scripts/
+│   └── setup.ts             # Interactive setup script
+├── makepkg/
+│   ├── index.ts             # Main makepkg entry
+│   ├── pkgbuild.ts          # PKGBUILD parser
+│   ├── source.ts            # Source download/extraction
+│   ├── build.ts             # build()/package() execution
+│   └── printsrcinfo.ts      # .SRCINFO generation
+├── ui/                      # User interface (prompt, formatting)
+└── index.ts                 # Entry point
+```
+
+```
+lib/pac4deb/                 # libalpm C library
+├── Makefile                 # Build with gcc, target libalpm.so
+├── include/
+│   ├── alpm.h               # Public libalpm API header
+│   └── alpm_list.h          # Linked list header
+└── src/
+    ├── libalpm.c            # Core implementation (handle, db, pkg, JSON parser)
+    ├── stubs_manual.c       # ~200 stubs for rarely-used libalpm functions
+    └── alpm_list.c          # Linked list implementation
+```
+
+## Database
+
+### Local database: `/var/lib/pacman-debian/local/`
+
+Directory-per-package format matching Arch Linux's local DB:
+
+```
+/var/lib/pacman-debian/local/
+├── index.json       # name → dir mapping (base64 encoded paths)
+├── by-name/
+│   ├── fastfetch -> ../fastfetch-2.64.2-2/
+│   └── ...
+├── fastfetch-2.64.2-2/
+│   ├── desc          # JSON metadata (name, version, deps, size, etc.)
+│   └── files         # File manifest
+└── ...
+```
+
+### dpkg compatibility
+
+Packages installed via `dpkg` or `apt` are read directly from
+`/var/lib/dpkg/status` at query time (mtime-cached). When `pacman-debian`
+installs a package, it writes a dpkg-compatible entry ensuring `apt` and `dpkg`
+still see the package.
+
+### Repository cache: `/var/cache/pacman-debian/packages/`
+
+Each repository is cached in JSON Lines chunks (5000 packages per `.jsonl`
+file). During sync, a `packages.idx` index is also built — one line per
+package, sorted globally, with format `pkgname description\tprovides\tchunk\toffset`.
+
+```
+/var/cache/pacman-debian/packages/
+├── bookworm/
+│   ├── 00000.jsonl   # JSON Lines, ~5000 pkg per chunk
+│   ├── ...
+│   └── packages.idx  # Global sorted index (tabs, ~200KB)
+└── ...
+```
+
+#### Memory Index Cache
+
+`packages.idx` is cached in memory after first read, keyed by repo name + mtime:
+
+```
+_idxCache = new Map<string, IdxEntry>();
+IdxEntry { lines: string[], mtime: number, providesIndex: Map<string, Array<{chunkFile, offset}>> }
+```
+
+- Subsequent `-S`/`-Ss`/`-Sl` operations read from memory, no disk I/O
+- `providesIndex` is an inverted index: `provides name → [{ chunkFile, offset }]`
+  - `findProvider()` does O(1) `Map.get()` for provides lookups
+- `pacman -Syy` clears the cache (`invalidateIdxCache()`)
+- After incremental sync, idx file mtime changes → auto reload
+
+### Lookup Paths
+
+| Operation | Method | Why |
+|-----------|--------|-----|
+| `-S <pkg>` / `-Qo` | Binary search `packages.idx` → seek JSONL | O(log N), single line read |
+| `-Ss` | Line-scan `packages.idx` (name + desc) → seek JSONL | ~1.4MB scan, no JSON parse |
+| `-Sl` | Read `packages.idx` → seek each pkg | Lazy-load via index |
+| Dependency provides | Scan `packages.idx` provides field | Index-only, no JSON parse |
+| `-Qi` / `-Ql` | dpkg status or localdb | No cache involved |
+
+## Dependency Engine
+
+The dependency resolver (`src/core/deps.ts`) handles:
+
+- Package name parsing with version constraints (`>=`, `<=`, `=`)
+- OR dependencies (`|`)
+- Architecture qualifiers (e.g. `:arm64`, `:amd64`)
+- Both Debian (comma-separated) and Arch (space-separated) formats
+- BFS resolution with pre-loaded DB state
+- Conflict detection across installed and to-be-installed packages
+- System package protection (glibc, libc6, etc.)
+
+- File validation: installed packages with no real files on disk are
+  considered NOT installed, forcing re-download.
+- Explicit targets always have their dependencies processed even if the
+  target itself is already installed.
+- Queue uses `shift()` to pop processed items, preventing memory accumulation.
+
+### Performance Optimizations
+
+| Technique | Description |
+|-----------|-------------|
+| **idx memory cache** | `findInRepo()` binary search on `_idxCache.lines[]` in memory |
+| **provides inverted index** | `findProvider()` does `Map.get()` O(1) |
+| **BFS + cursor** | Dependency queue uses index pointer instead of `shift()` |
+| **batch head-tail scan** | Binary searches sorted idx from both ends simultaneously |
+| **keep-alive HTTP** | Shared `https.Agent({ keepAlive: true, maxSockets: 8 })` |
+| **async .gz decompress** | Non-blocking zlib with callback |
+| **304 conditional requests** | Sync sends `If-Modified-Since`, skip unchanged repos |
+
+### Delete Dependency Handling
+
+| Operation | Logic |
+|-----------|-------|
+| `-R` | Remove specified package only |
+| `-Rs` | Remove package + recursive orphan find, reverse-topological order |
+| `-Rc` | Cascade: find all packages requiring the target |
+| `-Rsc` | Recursive + cascade combination |
+| `-Rn` | Backup conffiles as `.dpkg-old`, then remove |
+
+Removal auto-sorts dependents first (leaves before roots).
+
+## Repository Support
+
+- **Debian/Ubuntu**: Reads `Packages.gz` / `Packages.xz` from standard
+  repository indices. Supports `$repo`/`$arch` variable substitution.
+- **Arch Linux**: Reads `db.tar.gz` from Arch-compatible repositories.
+  Downloaded `.pkg.tar.zst` files are extracted and installed.
+- **Arch ARM**: Binary packages require glibc 2.38+ — Debian 12 ships 2.36.
+  Use `makepkg` for local builds instead.
+
+## Project Status
+
+Key features:
+
+- **Performance**: `packages.idx` index enables sub-second single-package lookup.
+- **Parallel sync**: Repos sync concurrently with per-repo progress display.
+- **i18n**: Full Chinese and English localization via `$LANG` detection.
+- **Color**: Matching official pacman color scheme.
+- **Root check**: Query commands work without root; write operations require `sudo`.
+- **Link system** (`paclink`): Debian→Arch virtual package name mappings.
+
+Key limitations:
+
+- **Arch ARM binary repos require glibc 2.38+** — Debian 12 ships 2.36.
+- **yay/AUR**: libalpm stub library works for search and dep resolution, but
+  complex AUR dependency chains may fail due to Debian/Arch naming differences.

package/docs/en/configuration.md

@@ -0,0 +1,84 @@
+# Configuration
+
+Configuration file: `/etc/pacman-debian/pacman.conf`
+
+The configuration uses pure Arch Linux pacman syntax with `Include` directives.
+Repo-specific keys (`Type`, `Dist`, `Components` for Debian repos) go in
+included files under `/etc/pacman.d/`.
+
+## Example
+
+```ini
+[options]
+Architecture = auto
+
+[bookworm]
+Include = /etc/pacman.d/debian-bookworm
+
+[extra]
+Include = /etc/pacman.d/arch-extra
+```
+
+Include file `/etc/pacman.d/debian-bookworm`:
+
+```
+Server = https://mirrors.tuna.tsinghua.edu.cn/debian
+Type = debian
+Dist = bookworm
+Components = main contrib non-free non-free-firmware
+```
+
+Include file for Arch repos `/etc/pacman.d/arch-extra`:
+
+```
+Server = http://mirror.archlinuxarm.org/$arch/$repo
+Type = arch
+Architecture = auto
+```
+
+## Repo Types
+
+### Debian
+
+| Key | Required | Description |
+|-----|----------|-------------|
+| `Server` | Yes | Mirror URL (supports `$repo`, `$arch` substitution) |
+| `Type` | Yes | Must be `debian` |
+| `Dist` | Yes | Distribution codename (e.g., `bookworm`, `trixie`) |
+| `Components` | Yes | Space-separated component list (`main contrib non-free`) |
+
+### Arch
+
+| Key | Required | Description |
+|-----|----------|-------------|
+| `Server` | Yes | Mirror URL (supports `$repo`, `$arch` substitution) |
+| `Type` | Yes | Must be `arch` |
+| `Architecture` | No | Set to `auto` to match system arch |
+
+## Symlink
+
+A symlink at `/etc/pacman.conf` → `/etc/pacman-debian/pacman.conf` is created
+during setup for compatibility with tools that hardcode this path (e.g., yay).
+
+## Viewing Parsed Config
+
+Use `pacman-conf` to view the configuration with all `Include` files resolved
+and `$repo`/`$arch` variables substituted:
+
+```bash
+$ pacman-conf
+# pacman-debian configuration
+[options]
+Architecture = auto
+
+[bookworm]
+Server = https://mirrors.tuna.tsinghua.edu.cn/debian
+Type = debian
+Dist = bookworm
+Components = main contrib non-free non-free-firmware
+
+[extra]
+Server = http://mirror.archlinuxarm.org/$arch/$repo
+Type = arch
+Architecture = auto
+```

package/docs/en/installation.md

@@ -0,0 +1,67 @@
+# Installation
+
+## Requirements
+
+- Node.js 18+
+- Debian-based distribution (Debian, Ubuntu, Armbian, Linux Mint, etc.)
+- Root privileges for install, remove, and upgrade operations
+- Build essentials: `gcc`, `make`, `ldconfig` (for libalpm C library, optional)
+
+## npm Install (Recommended)
+
+```bash
+npm install -g pacman-debian@latest
+sudo $(which pacman-debian-setup)
+```
+
+> [!WARNING]
+> `npm install -g` **must** be run under `sudo` or as the `root` user.
+> If you install as a regular user, Node.js will place `pacman-debian` into
+> your home directory (`~/.npm-global/` or similar), making it susceptible to
+> tampering, malicious modification, or breakage by other users or scripts on
+> the system. Always use `sudo npm install -g`.
+
+### What setup does
+
+1. Creates default config `/etc/pacman-debian/pacman.conf`
+2. Creates `/etc/pacman.conf` → `/etc/pacman-debian/pacman.conf` symlink
+3. Creates CLI symlinks (`/usr/local/bin/pacman`, `makepkg`, `pacman-conf`, `paclink`, `update-ca-trust`, `archlinux-java`, `fix_default`)
+4. Creates `/var/lib/pacman` → `/var/lib/pacman-debian` symlink for fastfetch detection
+5. Installs Arch-compat helper tools (`update-ca-trust`, `archlinux-java`, `fix_default`)
+6. Installs Arch-compat shell functions (`/etc/profile.d/append_path.sh`)
+7. Registers a virtual `pacman` package in dpkg status
+8. Creates default paclink mappings (sh → bash, python → python3, etc.)
+
+## Development Install
+
+```bash
+git clone https://github.com/xbodwf/pacman-debian.git
+cd pacman-debian
+pnpm install
+pnpm build                # tsc + C library
+sudo node dist/scripts/setup.js
+```
+
+Or set up manually:
+
+```bash
+sudo ln -sf "$PWD/dist/cli/pacman.js" /usr/local/bin/pacman
+sudo ln -sf "$PWD/dist/cli/paclink.js" /usr/local/bin/paclink
+sudo ln -sf "$PWD/dist/scripts/pacman-conf.js" /usr/local/bin/pacman-conf
+sudo ln -sf "$PWD/dist/makepkg/index.js" /usr/local/bin/makepkg
+```
+
+## First Use
+
+```bash
+# Sync repositories
+sudo pacman -Sy
+
+# Search
+pacman -Ss neofetch
+
+# Install
+sudo pacman -S neofetch
+```
+
+See [Usage](usage.md) for full command reference.

package/docs/en/makepkg.md

@@ -0,0 +1,38 @@
+# makepkg
+
+A standalone `makepkg` implementation that builds Arch Linux packages from
+PKGBUILDs without requiring `base-devel` or any Arch tools.
+
+```bash
+# Build a package from a PKGBUILD
+cd /path/to/PKGBUILD/dir
+makepkg --syncdeps --install
+```
+
+## Features
+
+- Parses PKGBUILD via bash sourcing (`source PKGBUILD`) — supports all
+  standard variables (`pkgname`, `pkgver`, `source`, `depends`, `makedepends`,
+  `sha256sums`, etc.)
+- Downloads and verifies source files (supports http/https URLs with checksum
+  verification)
+- Extracts archives: `.tar.gz`, `.tar.xz`, `.tar.bz2`, `.tar.zst`, `.zip`
+- Runs `prepare()`, `build()`, `check()`, and `package()` functions in a clean
+  environment
+- Creates `.pkg.tar.zst` archives with valid `.PKGINFO` metadata
+- Dependency resolution via `--syncdeps` — installs missing dependencies
+  through pacman-debian's sync databases (Debian and Arch repos)
+- Supports `--install` (`-i`), `--clean` (`-c`), `--rmdeps`
+
+## Flags
+
+| Flag | Description |
+|------|-------------|
+| `-s, --syncdeps` | Install missing dependencies via pacman |
+| `-i, --install` | Install the built package |
+| `-c, --clean` | Clean up build files after packaging |
+| `-r, --rmdeps` | Remove installed dependencies after build |
+| `-f, --force` | Overwrite existing package file |
+| `-o, --nobuild` | Download and extract sources only (no build) |
+| `--nocolor` | Disable colored output |
+| `--printsrcinfo` | Print `.SRCINFO` and exit |

package/docs/en/paclink.md

@@ -0,0 +1,73 @@
+# paclink (Package Link Management)
+
+Paclink manages persistent Debian→Arch virtual package name mappings.
+Links are stored in the local DB and visible only to pacman/libalpm tools,
+not dpkg.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `paclink -Ln <deb> <virt>` | Create a link: Debian package `<deb>` provides Arch virtual name `<virt>` |
+| `paclink -L` | List all links |
+| `paclink -Ls <keyword>` | Search links by name or target |
+| `paclink -Li <virt>` | Show link details |
+| `paclink -R <virt>` | Remove a link (Debian package unaffected) |
+
+## Examples
+
+```bash
+# Map dash to provide sh
+sudo paclink -Ln dash sh
+
+# Map python3 to provide python
+sudo paclink -Ln python3 python
+
+# List all mappings
+paclink -L
+
+# Search for links matching 'python'
+paclink -Ls python
+```
+
+## Behavior
+
+- Links are created as local DB entries with `repoType: link`.
+- When a real package from any repo shares the same name as a link, the real
+  package takes precedence and the link is automatically removed during
+  installation.
+- Links are only visible to pacman and libalpm — dpkg never sees them.
+
+## Default Links
+
+Setup creates the following default mappings:
+
+| Virtual Name | Debian Package |
+|-------------|----------------|
+| sh | bash (or dash) |
+| python | python3 |
+| zlib | zlib1g |
+| bzip2 | libbz2-1.0 |
+| xz | liblzma5 |
+| zstd | libzstd1 |
+| openssl | libssl-dev |
+| libssl | libssl3t64 |
+| libcrypt | libcrypt1 |
+| libffi | libffi8 |
+| libpcre | libpcre3 |
+| libpcre2 | libpcre2-8-0 |
+| libpng | libpng16-16t64 |
+| libjpeg-turbo | libjpeg62-turbo |
+| freetype2 | libfreetype6 |
+| ncurses | libncursesw6 |
+| readline | libreadline8t64 |
+| sqlite | libsqlite3-0 |
+| expat | libexpat1 |
+| libxml2 | libxml2 |
+| glibc | libc6 |
+| gcc-libs | libgcc-s1 |
+| libstdc++ | libstdc++6 |
+| systemd-libs | libsystemd0 |
+| gnutls | libgnutls30t64 |
+| libcurl | libcurl4t64 |
+| ca-certificates-utils | ca-certificates |

package/docs/en/usage.md

@@ -0,0 +1,91 @@
+# Usage
+
+## Sync (-S)
+
+| Command | Description |
+|---------|-------------|
+| `pacman -S <pkg>` | Install package(s) from repositories |
+| `pacman -Sy` | Refresh package databases (mtime check, 24h) |
+| `pacman -Syy` | Force refresh package databases (clear memory idx cache) |
+| `pacman -Su` | Upgrade all installed packages |
+| `pacman -Syu` | Refresh databases and upgrade |
+| `pacman -Ss <keyword>` | Search repositories |
+| `pacman -Si <pkg>` | Show remote package information |
+| `pacman -Sl` | List all packages in repositories |
+| `pacman -Sw <pkg>` | Download packages to cache without installing |
+| `pacman -Sc` | Remove unused cached package files |
+| `pacman -Scc` | Clear entire cache (including repo jsonl/idx) |
+| `pacman -Sp <pkg>` | Print download URL without installing |
+
+## Remove (-R)
+
+| Command | Description |
+|---------|-------------|
+| `pacman -R <pkg>` | Remove a package |
+| `pacman -Rs <pkg>` | Remove package and unused dependencies |
+| `pacman -Rn <pkg>` | Remove package and its config files (nosave) |
+| `pacman -Rns <pkg>` | Remove package, dependencies, config files |
+| `pacman -Rc <pkg>` | Cascade: remove packages that depend on the target |
+| `pacman -Rdd <pkg>` | Skip dependency checks during removal |
+| `pacman -Rp <pkg>` | Print what would be removed (dry-run) |
+
+Multiple targets (`pacman -R a b`): all targets are merged and displayed
+together with a single confirmation prompt.
+
+## Query (-Q)
+
+| Command | Description |
+|---------|-------------|
+| `pacman -Q` | List all installed packages |
+| `pacman -Qe` | List explicitly installed packages |
+| `pacman -Qd` | List packages installed as dependencies |
+| `pacman -Qdt` | List orphan packages (unused dependencies) |
+| `pacman -Qi <pkg>` | Show detailed package information |
+| `pacman -Ql <pkg>` | List files owned by a package |
+| `pacman -Qo <file>` | Query which package owns a file |
+| `pacman -Qs <keyword>` | Search installed packages |
+| `pacman -Qk [pkg]` | Verify installed package file integrity |
+| `pacman -Qq` | Quiet mode: package names only, no versions |
+
+## Other
+
+| Command | Description |
+|---------|-------------|
+| `pacman -U <file>` | Install a local package file (.deb/.pkg.tar.zst) |
+| `pacman -D --asdeps <pkg>` | Mark package as dependency |
+| `pacman -D --asexplicit <pkg>` | Mark package as explicitly installed |
+| `pacman -T <pkg>` | Check if dependencies are satisfied |
+| `pacman -F <file>` | Search which package provides a file |
+| `pacman -V` | Show version |
+
+## Bundled Tools
+
+| Command | Description |
+|---------|-------------|
+| `pacman-conf` | Print parsed configuration |
+| `makepkg` | Build Arch Linux packages from PKGBUILD (see [makepkg](makepkg.md)) |
+| `pacman-debian-setup` | Interactive setup script |
+| `paclink` | Manage Debian→Arch virtual package name mappings (see [paclink](paclink.md)) |
+| `update-ca-trust` | CA certificate updater (Arch-compat, wraps `update-ca-certificates`) |
+| `archlinux-java` | Java environment manager: `status`, `get`, `set`, `unset`, `fix` |
+| `fix_default` | Print current default JDK short name (used by Arch Java install scripts) |
+
+## Global Flags
+
+| Flag | Description |
+|------|-------------|
+| `--noconfirm` | Skip confirmation prompts |
+| `--confirm` | Always ask for confirmation (default) |
+| `--needed` | Do not reinstall up-to-date packages |
+| `--noscriptlet` | Do not execute install scripts |
+| `--print` | Dry-run: show what would be done without executing |
+
+## Config Options (in `pacman.conf [options]`)
+
+| Option | Description |
+|--------|-------------|
+| `Color` | Enable colored output |
+| `Architecture` | Set target architecture (default: `auto`) |
+| `IgnorePkg` | Skip upgrade for specified packages |
+
+See [Configuration](configuration.md) for detailed config reference.