1. Introduction umtool is a command-line utility designed for managing users, modules, or Unicode data (depending on version). This guide covers the most common operations: installation, basic usage, and advanced options. 2. Installation Linux / macOS # Download binary sudo curl -L https://example.com/umtool -o /usr/local/bin/umtool sudo chmod +x /usr/local/bin/umtool Windows Place umtool.exe in C:\Windows\System32 or add to PATH.
umtool --version umtool [global options] <command> [subcommand] [arguments] 4. Common Commands 4.1 User Management (if applicable) | Command | Description | |---------|-------------| | umtool user add <name> | Create new user | | umtool user list | List all users | | umtool user delete <id> | Remove user | | umtool user role set <user> <role> | Assign role | 4.2 Module Management | Command | Description | |---------|-------------| | umtool module install <name> | Install module | | umtool module enable <id> | Enable module | | umtool module status | Show module health | 4.3 Unicode / Text Utilities | Command | Description | |---------|-------------| | umtool unicode normalize <file> | Normalize Unicode text (NFC, NFD) | | umtool unicode detect <file> | Detect encoding | | umtool unicode strip <file> | Remove control characters | 5. Practical Examples Example 1: Add a new system user with sudo access umtool user add jdoe --home /home/jdoe --shell /bin/bash --sudo Example 2: Batch install modules from a manifest umtool module install --manifest modules.txt Example 3: Normalize a CSV file to Unicode NFC form umtool unicode normalize input.csv --form NFC --output clean.csv 6. Global Options | Option | Effect | |--------|--------| | --verbose | Show detailed logs | | --config <file> | Use custom config file | | --quiet | Suppress non-error output | | --dry-run | Simulate without changes | 7. Configuration File (YAML) Example ~/.umtoolrc : umtool
Verify installation:
defaults: user_shell: /bin/bash home_prefix: /srv/users modules: auto_enable: true unicode: default_form: NFC | Problem | Solution | |---------|----------| | command not found | Add umtool to PATH or reinstall | | permission denied | Run with sudo or as admin | | module not found | Run umtool module update first | | UnicodeDecodeError | Specify encoding: --encoding utf-8 | 9. Uninstalling sudo rm /usr/local/bin/umtool # Linux/macOS # Windows: delete umtool.exe and remove from PATH 10. Getting Help umtool --help umtool <command> --help man umtool # if installed If you have a specific umtool (e.g., from UnicodeTools , UserManagementTool , or UniversalModuleTool ), please provide its source or full name for a more accurate guide. Common Commands 4