├── .github └── workflows │ └── hugo.yml ├── .gitignore ├── .gitmodules ├── .prettierrc ├── LICENSE ├── README.md ├── archetypes └── default.md ├── assets └── css │ ├── fonts.css │ └── theme-gobolinux.css ├── config ├── _default │ └── config.toml └── v017 │ └── config.toml ├── content ├── LICENSE ├── latest │ ├── Advanced │ │ ├── Fibo.md │ │ ├── GoboHide.md │ │ ├── GoboLinux-Design-Quirks │ │ │ ├── Files-that-cannot-be-symlinks.md │ │ │ ├── Replacements-for-standard-commands.md │ │ │ ├── Sandboxing-under-GoboLinux.md │ │ │ └── _index.md │ │ ├── GoboLinux-FAQ.md │ │ ├── GoboLinux-Scripts │ │ │ ├── GoboPath.md │ │ │ ├── Guidelines-for-script-authors.md │ │ │ ├── Notes-on-command-line-switches.md │ │ │ └── _index.md │ │ ├── Legacy-Applications.md │ │ ├── Manager.md │ │ ├── Startup and System settings │ │ │ ├── Boot-Themes │ │ │ │ ├── Creating-a-boot-theme.md │ │ │ │ ├── Implementing-a-boot-theme.md │ │ │ │ ├── Testing-a-boot-theme.md │ │ │ │ └── _index.md │ │ │ ├── Boot-script-tasks.md │ │ │ ├── Configuring-the-boot-process.md │ │ │ └── _index.md │ │ ├── Steps-of-the-Compile-process.md │ │ ├── Suggestion-for-a-less-super-user-reliant-update-process.md │ │ └── _index.md │ ├── Commands │ │ ├── AddUser.md │ │ ├── Alien.md │ │ ├── ApplyVariables.md │ │ ├── AttachProgram.md │ │ ├── AugmentCommandNotFoundDatabase.md │ │ ├── AutoPatch.md │ │ ├── BackgroundExec.md │ │ ├── BootDriver.md │ │ ├── CheckDependants.md │ │ ├── CheckDependencies.md │ │ ├── CleanModules.md │ │ ├── ColorMake.md │ │ ├── CommandNotFound.md │ │ ├── Compile.md │ │ ├── ContributeRecipe.md │ │ ├── Corrections.md │ │ ├── CreatePackage.md │ │ ├── DeduceName.md │ │ ├── Dependencies.md │ │ ├── DescribeProgram.md │ │ ├── DetachProgram.md │ │ ├── DisableProgram.md │ │ ├── Docs.md │ │ ├── EditRecipe.md │ │ ├── FetchArchive.md │ │ ├── FiboSandbox.md │ │ ├── FilterColors.md │ │ ├── FilterLines.md │ │ ├── FindPackage.md │ │ ├── FindQuick.md │ │ ├── FixAttributes.md │ │ ├── FixDirReferences.md │ │ ├── FixInfo.md │ │ ├── Freshen.md │ │ ├── GenBuildInformation.md │ │ ├── GetAvailable.md │ │ ├── GetRecipe.md │ │ ├── GetSupportedFilesystems.md │ │ ├── GrepQuick.md │ │ ├── GrepReplace.md │ │ ├── GuessLatest.md │ │ ├── GuessProgramCase.md │ │ ├── Hashes.md │ │ ├── InstallPackage.md │ │ ├── Installer.md │ │ ├── IsExecutable.md │ │ ├── KeyManager.md │ │ ├── KillProcess.md │ │ ├── ListProgramFiles.md │ │ ├── MakeRecipe.md │ │ ├── MergeTree.md │ │ ├── NamingConventions.md │ │ ├── NewVersion.md │ │ ├── PackRecipe.md │ │ ├── PrepareProgram.md │ │ ├── PrioritiseUpdates.md │ │ ├── ProblemReport.md │ │ ├── RebuildLinks.md │ │ ├── RecipeLint.md │ │ ├── RemoveBroken.md │ │ ├── RemoveEmpty.md │ │ ├── RemoveProgram.md │ │ ├── Rename.md │ │ ├── RescueInstallPackage.md │ │ ├── RescueSymlinkProgram.md │ │ ├── Runner.md │ │ ├── SandboxInstall.md │ │ ├── SignProgram.md │ │ ├── StartTask.md │ │ ├── StopTask.md │ │ ├── SuggestDuplicates.md │ │ ├── SuggestUpdates.md │ │ ├── SymlinkProgram.md │ │ ├── SystemFind.md │ │ ├── SystemInfo.md │ │ ├── UnionSandbox.md │ │ ├── UnversionExecutables.md │ │ ├── UpdateKdeRecipe.md │ │ ├── UpdateRecipes.md │ │ ├── UpdateSettings.md │ │ ├── UpdateXorgRecipe.md │ │ ├── UpgradeSystem.md │ │ ├── UseFlags.md │ │ ├── VerifyProgram.md │ │ ├── VersionExecutables.md │ │ ├── _index.md │ │ ├── install.md │ │ ├── list.md │ │ └── which.md │ ├── Getting-Started │ │ ├── Configuration-files │ │ │ ├── Compile.conf.md │ │ │ ├── Environment-variables.md │ │ │ ├── GetAvailable.conf.md │ │ │ └── _index.md │ │ ├── Desktop-Environments │ │ │ ├── Awesome.md │ │ │ ├── Enlightenment.md │ │ │ ├── LXDE.md │ │ │ └── _index.md │ │ ├── GoboLinux-Filesystem-Hierarchy.md │ │ ├── Installing-Gobolinux │ │ │ ├── GoboLinux-Known-Issues-and-Fixes.md │ │ │ ├── Platforms │ │ │ │ ├── Installing-to-external-storage-devices.md │ │ │ │ ├── Running-GoboLinux-under-QEMU.md │ │ │ │ ├── Running-under-GNOME-Boxes.md │ │ │ │ ├── Running-under-HyperV.md │ │ │ │ ├── Running-under-VMWare-Workstation-Player.md │ │ │ │ ├── Running-under-VirtualBox.md │ │ │ │ ├── _index.md │ │ │ │ └── images │ │ │ │ │ └── virtualbox_storage.png │ │ │ └── _index.md │ │ ├── Installing-Software │ │ │ ├── Binary-packages.md │ │ │ ├── Compiling-from-source.md │ │ │ └── _index.md │ │ ├── Linux-kernel-topics.md │ │ ├── Package-Management │ │ │ ├── Dependencies-blacklist.md │ │ │ ├── Removing-programs.md │ │ │ ├── Understanding-and-maintaining-system-indices.md │ │ │ ├── Updating-programs.md │ │ │ └── _index.md │ │ ├── The-GoboLinux-Way.md │ │ └── _index.md │ ├── How-tos │ │ ├── Contributing-to-the-wiki.md │ │ ├── Filesystem-virtualization-with-Runner.md │ │ ├── GAMPS-Howto.md │ │ ├── Installing-packages-from-the-LiveCD.md │ │ ├── Manual-Compile.md │ │ ├── SandboxInstall-Howto.md │ │ ├── Set-external-mailto-handler-in-Firefox.md │ │ ├── Upgrade-Glibc.md │ │ └── _index.md │ ├── Recipes │ │ ├── GitHub-contributor-workflow.md │ │ ├── How-to-commit-recipes.md │ │ ├── Package-Naming-Guidelines.md │ │ ├── Recipe-Format-Specification.md │ │ ├── The-Recipe-File │ │ │ ├── Dynamic-variables.md │ │ │ ├── Getting-the-source.md │ │ │ ├── Hooks.md │ │ │ ├── Other-directives.md │ │ │ ├── Patches.md │ │ │ ├── Recipe-types.md │ │ │ ├── Resources1.md │ │ │ ├── Use-flags │ │ │ │ ├── Available-Use-Flags.md │ │ │ │ └── _index.md │ │ │ └── _index.md │ │ ├── Writing-Recipes │ │ │ ├── Advanced-topics.md │ │ │ ├── Binary-Recipes.md │ │ │ └── _index.md │ │ └── _index.md │ └── _index.md └── v017 │ ├── Commands │ ├── AddUser.md │ ├── Alien.md │ ├── ApplyVariables.md │ ├── AttachProgram.md │ ├── AugmentCommandNotFoundDatabase.md │ ├── AutoPatch.md │ ├── BackgroundExec.md │ ├── BootDriver.md │ ├── CheckDependants.md │ ├── CheckDependencies.md │ ├── CleanModules.md │ ├── ColorMake.md │ ├── CommandNotFound.md │ ├── Compile.md │ ├── ContributeRecipe.md │ ├── Corrections.md │ ├── CreatePackage.md │ ├── DeduceName.md │ ├── Dependencies.md │ ├── DescribeProgram.md │ ├── DetachProgram.md │ ├── DisableProgram.md │ ├── Docs.md │ ├── EditRecipe.md │ ├── FetchArchive.md │ ├── FiboSandbox.md │ ├── FilterColors.md │ ├── FilterLines.md │ ├── FindPackage.md │ ├── FindQuick.md │ ├── FixAttributes.md │ ├── FixDirReferences.md │ ├── FixInfo.md │ ├── Freshen.md │ ├── GenBuildInformation.md │ ├── GetAvailable.md │ ├── GetRecipe.md │ ├── GetSupportedFilesystems.md │ ├── GrepQuick.md │ ├── GrepReplace.md │ ├── GuessLatest.md │ ├── GuessProgramCase.md │ ├── Hashes.md │ ├── InstallPackage.md │ ├── Installer.md │ ├── IsExecutable.md │ ├── KeyManager.md │ ├── KillProcess.md │ ├── ListProgramFiles.md │ ├── MakeRecipe.md │ ├── MergeTree.md │ ├── NamingConventions.md │ ├── NewVersion.md │ ├── PackRecipe.md │ ├── PrepareProgram.md │ ├── PrioritiseUpdates.md │ ├── ProblemReport.md │ ├── RebuildLinks.md │ ├── RecipeLint.md │ ├── RemoveBroken.md │ ├── RemoveEmpty.md │ ├── RemoveProgram.md │ ├── Rename.md │ ├── RescueInstallPackage.md │ ├── RescueSymlinkProgram.md │ ├── Runner.md │ ├── SandboxInstall.md │ ├── SignProgram.md │ ├── StartTask.md │ ├── StopTask.md │ ├── SuggestDuplicates.md │ ├── SuggestUpdates.md │ ├── SymlinkProgram.md │ ├── SystemFind.md │ ├── SystemInfo.md │ ├── UnionSandbox.md │ ├── UnversionExecutables.md │ ├── UpdateKdeRecipe.md │ ├── UpdateRecipes.md │ ├── UpdateSettings.md │ ├── UpdateXorgRecipe.md │ ├── UpgradeSystem.md │ ├── UseFlags.md │ ├── VerifyProgram.md │ ├── VersionExecutables.md │ ├── _index.md │ ├── install.md │ ├── list.md │ └── which.md │ ├── Documentation │ ├── Boot-Themes │ │ ├── Creating-a-boot-theme.md │ │ ├── Implementing-a-boot-theme.md │ │ ├── Testing-a-boot-theme.md │ │ └── _index.md │ ├── Boot-script-tasks.md │ ├── Configuration-files │ │ ├── Compile.conf.md │ │ ├── GetAvailable.conf.md │ │ └── _index.md │ ├── Environment-variables.md │ ├── Fibo.md │ ├── Files-that-cannot-be-symlinks.md │ ├── GoboHide.md │ ├── GoboLinux-Embedded.md │ ├── GoboLinux-FAQ.md │ ├── GoboLinux-PPC.md │ ├── GoboPath.md │ ├── Legacy-Applications.md │ ├── Manager.md │ ├── Notes-on-command-line-switches.md │ ├── Replacements-for-standard-commands.md │ ├── Sandboxing-under-GoboLinux.md │ ├── Suggestion-for-a-less-super-user-reliant-update-process.md │ ├── Video-acceleration-with-Modesetting-on-016.01.md │ └── _index.md │ ├── Howtos │ ├── Filesystem-virtualization-with-Runner.md │ ├── GAMPS-Howto.md │ ├── HAL-Howto.md │ ├── Installing-packages-from-the-LiveCD.md │ ├── Java-on-GoboLinux.md │ ├── Manual-Compile.md │ ├── Package-Signing.md │ ├── SandboxInstall-Howto.md │ ├── Set-external-mailto-handler-in-Firefox.md │ ├── Upgrade-Glibc.md │ ├── Using-Ndiswrapper-with-proprietary-wireless-drivers.md │ └── _index.md │ ├── Overview │ ├── Configuring-the-boot-process.md │ ├── Desktop-Environments │ │ ├── Awesome.md │ │ ├── Enlightenment.md │ │ ├── LXDE.md │ │ └── _index.md │ ├── GoboLinux-Filesystem-Hierarchy.md │ ├── GoboLinux-Scripts │ │ ├── Guidelines-for-script-authors.md │ │ └── _index.md │ ├── GoboLinux-dark-corners.md │ ├── Installing-Gobolinux │ │ ├── GoboLinux-Known-Issues-and-Fixes.md │ │ └── _index.md │ ├── Installing-Software │ │ ├── Compiling-from-source.md │ │ ├── Steps-of-the-Compile-process.md │ │ ├── Using-binary-packages.md │ │ └── _index.md │ ├── Linux-kernel-topics.md │ ├── Package-Management │ │ ├── Dependencies-blacklist.md │ │ ├── Removing-programs.md │ │ ├── Understanding-and-maintaining-system-indices.md │ │ ├── Updating-packages.md │ │ └── _index.md │ ├── Platforms │ │ ├── Installing-to-external-storage-devices.md │ │ ├── Running-GoboLinux-under-QEMU.md │ │ ├── Running-under-GNOME-Boxes.md │ │ ├── Running-under-HyperV.md │ │ ├── Running-under-VMWare-Workstation-Player.md │ │ ├── Running-under-VirtualBox.md │ │ ├── _index.md │ │ └── images │ │ │ └── virtualbox_storage.png │ ├── System-Index.md │ ├── The-GoboLinux-Way.md │ ├── What-Makes-GoboLinux-Unique.md │ └── _index.md │ ├── Recipes │ ├── Binary-Recipes.md │ ├── GitHub-contributor-workflow.md │ ├── How-to-commit-recipes.md │ ├── Package-Naming-Guidelines.md │ ├── Recipe-Format-Specification.md │ ├── Recipe-types.md │ ├── Use-flags │ │ ├── Available-Use-Flags.md │ │ └── _index.md │ ├── Writing-Recipes.md │ └── _index.md │ └── _index.md ├── layouts ├── partials │ ├── favicon.html │ ├── logo.html │ └── menu-footer.html └── shortcodes │ └── toc.html └── static ├── fonts ├── LodeSansMono.otb ├── LodeSansMono.otf ├── MonaspaceKryptonVarVF[wght,wdth,slnt].woff2 ├── PublicSans-Light.woff2 ├── PublicSans-SemiBold.woff2 └── metropolis-bold-webfont.woff2 └── images ├── goboicon.png └── gobolinux_header.png /.gitignore: -------------------------------------------------------------------------------- 1 | .hugo_build.lock 2 | public/ -------------------------------------------------------------------------------- /.gitmodules: -------------------------------------------------------------------------------- 1 | [submodule "themes/hugo-theme-relearn"] 2 | path = themes/hugo-theme-relearn 3 | url = https://github.com/McShelby/hugo-theme-relearn.git 4 | -------------------------------------------------------------------------------- /.prettierrc: -------------------------------------------------------------------------------- 1 | tabWidth: 4 2 | overrides: 3 | - files: "*.md" 4 | options: 5 | proseWrap: "always" 6 | printWidth: 80 7 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2022 GoboLinux.org, NEONsys.org 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # GoboLinux Documentation 2 | 3 | Here resides the official GoboLinux Documentation. 4 | 5 | It has been build using [Hugo Static Site Generator](https://gohugo.io/), based 6 | on the wonderful 7 | [Hugo Relearn Theme](https://mcshelby.github.io/hugo-theme-relearn/). 8 | 9 | ## Project Structure 10 | 11 | You will find the documentation under the `content/` in markdown format. The 12 | projects main stylesheet lays under `assets/css/`. 13 | 14 | The projects configuration is stored under `config/`. 15 | 16 | If you need more info consult the official 17 | [Hugo](https://gohugo.io/documentation/) and 18 | [Hugo Relearn Theme](https://mcshelby.github.io/hugo-theme-relearn/) docs. 19 | 20 | ## How to run Documentation locally 21 | 22 | 1. Install [Hugo](https://gohugo.io/). If you are on GoboLinux simply run 23 | `Compile Hugo`. 24 | 25 | 2. Clone this repository _including submodules_: 26 | 27 | ```shell 28 | git clone --recurse-submodules https://github.com/gobolinux/Documentation.git 29 | ``` 30 | 31 | 3. Enter the project directory and type `hugo serve` 32 | 33 | 4. Open http://localhost:1313/ (by default) 34 | 35 | 5. That's it! Any project changes will be automatically reflected on your local 36 | server. 37 | 38 | ## Note to Contributors 39 | 40 | Contributions to the documentation (residing within `content/`) are licensed 41 | under CC BY-SA 3.0. 42 | 43 | The project source code is licensed under the MIT License. 44 | 45 | So feel free and even encouraged to submit your contributions! ❤️ 46 | -------------------------------------------------------------------------------- /archetypes/default.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "{{ replace .Name "-" " " | title }}" 3 | date: {{ .Date }} 4 | draft: true 5 | --- 6 | 7 | -------------------------------------------------------------------------------- /assets/css/fonts.css: -------------------------------------------------------------------------------- 1 | /* Main font */ 2 | @font-face { 3 | font-family: "Public Sans"; 4 | font-style: normal; 5 | font-weight: 300; 6 | src: url("../fonts/PublicSans-Light.woff2") format("woff2"); 7 | font-display: swap; 8 | } 9 | 10 | @font-face { 11 | font-family: "Public Sans"; 12 | font-style: normal; 13 | font-weight: 600; 14 | src: url("../fonts/PublicSans-SemiBold.woff2") format("woff2"); 15 | font-display: swap; 16 | } 17 | 18 | /* Headline font */ 19 | @font-face { 20 | font-family: "Metropolis"; 21 | font-style: normal; 22 | font-weight: 500; 23 | src: url("../fonts/metropolis-bold-webfont.woff2") format("woff2"); 24 | font-display: swap; 25 | } 26 | 27 | /* Code font */ 28 | @font-face { 29 | font-family: "Krypton"; 30 | font-style: normal; 31 | font-weight: 400; 32 | src: url("../fonts/MonaspaceKryptonVarVF[wght,wdth,slnt].woff2") format("woff2"); 33 | font-display: swap; 34 | } 35 | 36 | /* @font-face { 37 | font-family: 'Lode Sans Mono'; 38 | font-style: normal; 39 | font-weight: 300; 40 | src: url("../fonts/LodeSansMono.otf") format("opentype"); 41 | font-display: swap; 42 | } */ -------------------------------------------------------------------------------- /config/v017/config.toml: -------------------------------------------------------------------------------- 1 | # Archived docs of GoboLinux v017 2 | baseURL = 'https://wiki.gobolinux.org/v017/' 3 | contentDir = "content/v017" 4 | publishDir = "public/v017" 5 | 6 | [params] 7 | version="017" 8 | editURL = "https://github.com/gobolinux/Documentation/edit/master/content/v017/" -------------------------------------------------------------------------------- /content/latest/Advanced/Fibo.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Fibo" 3 | hidden: true 4 | --- 5 | 6 | In GoboLinux, `Fibo` is a special user that assists Gobo, the superuser, during 7 | program installation. `Fibo` is responsible for the 8 | [`FiboSandbox`]({{%relref "FiboSandbox" %}}), he is the only one who is given 9 | access to it. 10 | 11 | Fibo is similar to the Unix `nobody` user, but the fundamental difference is 12 | while `nobody` **never** has write access to anything, Fibo is occasionally 13 | granted write permission to selected locations (specifically, during program 14 | installation, to the [`FiboSandbox`]({{%relref "FiboSandbox" %}}) and to the 15 | `/Programs` entry of the program being installed). 16 | 17 | In a standard GoboLinux system, `Fibo` is userid 21 (which is, of course, a 18 | number of the 19 | [Fibonacci sequence](http://en.wikipedia.org/wiki/Fibonacci_sequence)). 20 | -------------------------------------------------------------------------------- /content/latest/Advanced/GoboLinux-Design-Quirks/Files-that-cannot-be-symlinks.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Files that cannot be symlinks" 3 | weight: 1 4 | --- 5 | 6 | Symbolic links play a major role in a GoboLinux system, but some programs don't 7 | behave as expected when they are used. This section lists the files that cannot 8 | be symlinks. 9 | 10 | _"That is the reason why /System/Settings is not /System/Index/Settings: it does 11 | not only contain links, by definition (or, better put, by necessity)" -- Hisham 12 | Muhammad_ 13 | 14 | - `/System/Settings/sudoers` 15 | 16 | The configuration file for _sudo_ must be a regular file. If it is not, `sudo` 17 | will complain and do nothing. 18 | 19 | - `/System/Settings/passwd` and friends 20 | 21 | The settings files used by the Shadow package are quite interesting. 22 | Theoretically, they can be symlinks, but there is a caveat: utilities like 23 | useradd don't just modify these files; they remove and recreate them as regular 24 | files. Hence, in practice, they cannot be symbolic links. 25 | -------------------------------------------------------------------------------- /content/latest/Advanced/GoboLinux-Design-Quirks/Sandboxing-under-GoboLinux.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Sandboxing under GoboLinux" 3 | weight: 2 4 | --- 5 | 6 | The **build system** in GoboLinux uses sandboxing to ensure that all the 7 | filesystem writes during the software install phase are limited to an 8 | appropriate part of the filesystem. GoboLinux 016 ships with two different 9 | sandbox implementations. 10 | 11 | [UnionSandbox]({{%relref "UnionSandbox" %}}) is a modern implementation which uses 12 | file system unions to achieve isolation. It is the default sandbox installer. 13 | 14 | **FiboSandbox** is a fallback method used when a union-filesystem implementation 15 | is not available in the running kernel. It sets up an isolated environment and 16 | commands are run by a special user (named `fibo`) without root privileges. 17 | 18 | During the installation phase of the software build process, most build systems 19 | call the `install` program to copy files to their destination directories with 20 | the proper ownership and attributes. `install` belongs to the `CoreUtils` 21 | package. 22 | 23 | Since user **fibo** lacks authority to change file ownership, the link at 24 | `/System/Index/bin/install` points to a wrapper script in the `Scripts` package. 25 | 26 | Under **UnionSandbox**, this wrapper script translates the superuser name if 27 | necessary and calls `real_install`, a symlink to the CoreUtils `install` 28 | utility, passing along the modified arguments. 29 | 30 | Under **FiboSandbox**, the wrapper discards change-of-owner directives before 31 | calling `real_install`. 32 | -------------------------------------------------------------------------------- /content/latest/Advanced/GoboLinux-Design-Quirks/_index.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "GoboLinux Dark Corners" 3 | linkTitle: "GoboLinux Design Quirks" 4 | --- 5 | 6 | GoboLinux has some design features to assist adapting software builds to the 7 | GoboLinux directory structure. 8 | 9 | {{% children depth="1" %}} 10 | -------------------------------------------------------------------------------- /content/latest/Advanced/GoboLinux-Scripts/GoboPath.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "GoboPath" 3 | weight: 2 4 | --- 5 | 6 | This script is used everywhere inside many scripts. It exports shell variables 7 | such as `$goboExecutables`, `$goboUsers`, `$goboKernel`, and so on, which 8 | contains a string specifying where in the file system these entries are 9 | (`/System/Index/bin`, `/Users`, `/System/Kernel`, and so on). 10 | 11 | For example, in the `Scripts` package, within the `bin/` subdirectory are files 12 | such as `ScriptFunctions` or `SuggestUpdates`, among others. These source 13 | `GoboPath` via: 14 | 15 | ```fish 16 | . GoboPath 17 | ``` 18 | 19 | This is normally within the `Scripts` package, at `bin/GoboPath`. The whole 20 | GoboLinux hierarchy is kept as referential prefix in that file. The variable 21 | `$goboPrefix` keeps track as to where GoboLinux is mounted at. 22 | 23 | Let's avoid hardcoding things, sourcing this file and using these variables 24 | makes the world a better place :-) 25 | -------------------------------------------------------------------------------- /content/latest/Advanced/Legacy-Applications.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Legacy Applications" 3 | hidden: true 4 | --- 5 | 6 | ## This page lists legacy applications which are no longer maintained 7 | 8 | - [`Freshen`]({{%relref "Freshen" %}}) is a console application that checks for 9 | updated GoboLinux recipes and packages, with an output similar to "emerge" 10 | in Gentoo. 11 | -------------------------------------------------------------------------------- /content/latest/Advanced/Manager.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Manager" 3 | hidden: true 4 | --- 5 | 6 | The `Manager` program is presently (August 2017) no longer maintained. 7 | 8 | More information about it may be provided at a later time here at the wiki. 9 | 10 | The old code can still be found here, at the least as of August 2017: 11 | 12 | https://github.com/gobolinux/Manager 13 | -------------------------------------------------------------------------------- /content/latest/Advanced/Startup and System settings/Boot-Themes/Creating-a-boot-theme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Creating a boot theme" 3 | weight: 1 4 | --- 5 | 6 | This section explains how you can create your own boot script theme. 7 | 8 | Section "The boot scripts anatomy" already explained that a theme is a single 9 | script file. In fact, if you really want, you can create a theme that spreads 10 | through multiple files (but this is not necessarily a good idea). The point here 11 | is that one file is enough. This file implements a five functions: ThemeInit, 12 | ThemeFinish, ThemeBefore ThemeAfter, and ThemeFile. 13 | 14 | So, if you want to create a boot theme for GoboLinux, all you have to do is to 15 | create a script file like 16 | `/Programs/BootScripts/**/Themes/MyVeryOwnBootTheme` that implements 17 | those functions (and optionally something in the script body) with all the bells 18 | and whistles you want. 19 | 20 | ### Subtopics: 21 | 22 | 1. [Implementing a boot theme]({{%relref "Implementing-a-boot-theme" %}}) 23 | 2. [Testing a boot theme]({{%relref "Testing-a-boot-theme" %}}) 24 | -------------------------------------------------------------------------------- /content/latest/Advanced/Startup and System settings/Boot-Themes/Testing-a-boot-theme.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Testing a boot theme" 3 | weight: 3 4 | --- 5 | 6 | Fortunately you don't have to reboot your computer to test every feature you add 7 | to your boot theme. The `TestBootTheme` script is your friend. Just run it 8 | passing your boot script name as a parameter: 9 | 10 | ```fish 11 | TestBootTheme MyVeryOwnBootTheme 12 | ``` 13 | 14 | This will simulate a boot procedure with lots of things getting executed. Some 15 | of them will be quiet, some will echo a lot of text, some will succeed, some 16 | will fail... Just press enter when it ends up at the "login" prompt to finish. 17 | If you don't give it a Theme name, it will output the list of available Themes 18 | from `/Programs/BootScripts/Current/Themes/` instead. 19 | 20 | Of course, this script is also useful to see how the various boot themes are, so 21 | that you can choose which one is your favorite. 22 | 23 | {{% notice note %}} Some themes may not display correctly in an 24 | Xterm/Konsole/other graphical terminal, or with a non-standard console font. 25 | It's probably best to run TestBootTheme in the same environment you boot in! 26 | {{% /notice %}} 27 | -------------------------------------------------------------------------------- /content/latest/Advanced/Startup and System settings/Boot-script-tasks.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Boot Script Tasks" 3 | weight: 2 4 | --- 5 | 6 | Your boot scripts can make use of "boot tasks", which are little service scripts 7 | that can be shipped by programs. A program includes its tasks under 8 | `Resources/Tasks`, and they're linked in `/System/Tasks`. This is roughly 9 | equivalent to the `/etc/init.d` scripts found in many distributions. 10 | 11 | You can launch or stop tasks from the command line, using 12 | [`StartTask`]({{%relref "StartTask" %}}) and [`StopTask`]({{%relref "StopTask" %}}). 13 | For example, the following command will load the SSH daemon: 14 | 15 | ```fish 16 | StartTask OpenSSH 17 | ``` 18 | 19 | Within boot scripts, you don't need to use these launchers, but you have to add 20 | a parameter indicating whether the task is being started or stopped: 21 | 22 | ```fish 23 | Exec "Initializing OpenSSH server..." OpenSSH Start 24 | ``` 25 | 26 | ## Creating tasks 27 | 28 | Strictly speaking, a task is simply a shell script put in the appropriate 29 | directory, which accepts `start` and `stop` parameters. In this imaginary 30 | example, one could have a file `/Programs/Foo/1.0/Resources/Tasks/Foo` with 31 | these contents: 32 | 33 | ```fish 34 | #!/bin/sh 35 | 36 | case "$1" in 37 | [Ss]tart) 38 | # actions to start foo go here 39 | foo --silly-walk 40 | ;; 41 | [Ss]top) 42 | # actions to stop foo go here 43 | killall foo 44 | ;; 45 | esac 46 | ``` 47 | 48 | It's a good idea to use the above example as a template for tasks you create. 49 | The `[Ss]` syntax ensures that both `start` and `Start` are recognized, which is 50 | nice to avoid typos. 51 | -------------------------------------------------------------------------------- /content/latest/Advanced/Startup and System settings/_index.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Startup & System Settings" 3 | weight: 1 4 | --- 5 | 6 | {{% children depth="2" %}} 7 | -------------------------------------------------------------------------------- /content/latest/Advanced/Suggestion-for-a-less-super-user-reliant-update-process.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Suggestion for a less super user reliant update process" 3 | hidden: true 4 | --- 5 | 6 | The current update process in gobolinux requires super-user privileges. This is 7 | sub-optimal. 8 | 9 | In the following, a rough sketch of how to remedy this is proposed. 10 | 11 | ## Add a `gobo` user/group by default 12 | 13 | - The primary user of the system will be added to the the `gobo` group during 14 | installation. 15 | - Add a sudoers snippet that allows members of the `gobo` group to run 16 | system-update related scripts with no password for convenience 17 | - Ensure that `/Data/Compile/{Archives,Recipes,Sources}` are reset to 18 | `chown -Rc gobo:gobo` and `chmod ug+rw` on each system-update related script 19 | run, possibly in a function (a script version of which should be part of the 20 | set of commands allowed to run without a sudo password for convenience). 21 | - Find a clever way to not clutter commands that require being run as `root` 22 | or `gobo` -- possibly using functions? 23 | - This should make it easy to discern which commands need what privileges. 24 | -------------------------------------------------------------------------------- /content/latest/Advanced/_index.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Advanced" 3 | weight: 2 4 | chapter: false 5 | pre: "002 " 6 | --- 7 | 8 | {{% children depth="2" %}} 9 | -------------------------------------------------------------------------------- /content/latest/Commands/Alien.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Alien" 3 | --- 4 | 5 | ``` 6 | Usage: Alien -- AlienType:alienpkg [...] 7 | 8 | Valid options for are: 9 | --get-version 10 | --getinstallversion 11 | --greater-than 12 | --met|--within-range|--interval 13 | --have-manager 14 | --get-manager-rule 15 | --install 16 | 17 | Valid options for AlienType are: 18 | CPAN 19 | LuaRocks 20 | PIP 21 | RubyGems 22 | 23 | Example: 24 | Alien --install CPAN:XML::Parser 25 | Alien --install PIP:burn 26 | ``` 27 | -------------------------------------------------------------------------------- /content/latest/Commands/ApplyVariables.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "ApplyVariables" 3 | --- 4 | 5 | ``` 6 | NAME 7 | ApplyVariables - 8 | 9 | SYNOPSIS 10 | ApplyVariables 11 | 12 | OPTIONS 13 | --terse 14 | 15 | Enable terse messages. 16 | 17 | --debug 18 | 19 | Enable debug messages. 20 | 21 | -h, --help 22 | 23 | Show this help. 24 | 25 | --version 26 | 27 | Show program version. 28 | 29 | -v, --verbose 30 | 31 | Enable verbose mode. 32 | 33 | --logfile 34 | 35 | Log all output to specified file. 36 | 37 | -o, --open 38 | 39 | Opening mark. The default value is '@%'. 40 | 41 | -c, --close 42 | 43 | Closing mark. The default value is '%@'. 44 | 45 | -i, --identifier 46 | 47 | Add a prefix identifier in the form of '_' to the opening markup. 48 | 49 | Notes: 50 | ApplyVariables processes a file replacing instances of variables marked 51 | 52 | with special indicators ('@%', '%@' by default) with the contents of equivalent environment variables. 53 | 54 | GoboLinux March 2017 APPLYVARIABLES(1) 55 | ``` 56 | -------------------------------------------------------------------------------- /content/latest/Commands/AttachProgram.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "AttachProgram" 3 | --- 4 | 5 | ``` 6 | NAME 7 | AttachProgram - 8 | 9 | SYNOPSIS 10 | AttachProgram [] [] 11 | 12 | DESCRIPTION 13 | Create a link in /Programs to $goboInstall or . 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -b, --batch 41 | 42 | Batch mode. 43 | 44 | -f, --force 45 | 46 | Force, reattach even if installed. 47 | 48 | -r, --rootfs 49 | 50 | Move to RootFS. 51 | 52 | -D, --no-dependencies 53 | 54 | Do not try to fullfit dependencies. 55 | 56 | Notes: 57 | This script creates a program entry in /Programs with a version symlink to directory. After it is 58 | tied into /Programs, SymlinkProgram is executed. If is omitted the env var goboInstall is used. 59 | 60 | EXAMPLES 61 | AttachProgram GCC 2.95.3 /Network/Programs 62 | 63 | COPYRIGHT 64 | Copyright © 2004 Carlo Calica. Released under the GNU GPL. 65 | 66 | GoboLinux March 2017 ATTACHPROGRAM(1) 67 | ``` 68 | -------------------------------------------------------------------------------- /content/latest/Commands/AugmentCommandNotFoundDatabase.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "AugmentCommandNotFoundDatabase" 3 | --- 4 | 5 | This commands augments the existing database for 6 | [CommandNotFound](../CommandNotFound) suggestions with data from the running 7 | system. In other words, it looks at which executables exist in the installed 8 | system and adds them to the `/Data/CommandNotFound.data` file from Scripts. 9 | 10 | This is useful to improve the quality of the "command not found" suggestions. 11 | Users are encouraged to send patches to Scripts improving the 12 | `CommandNotFound.data` database. 13 | -------------------------------------------------------------------------------- /content/latest/Commands/AutoPatch.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "AutoPatch" 3 | --- 4 | 5 | ``` 6 | NAME 7 | AutoPatch - 8 | 9 | SYNOPSIS 10 | AutoPatch 11 | 12 | DESCRIPTION 13 | Compile patch streamlining tool. Run it once, edit the sources and run it again. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -c, --clean 41 | 42 | Cleanup directories in Archives. 43 | 44 | EXAMPLES 45 | AutoPatch Bullet 46 | 47 | COPYRIGHT 48 | Copyright © Hisham Muhammad, 2014 - Released under the GNU GPL. 49 | 50 | GoboLinux March 2017 AUTOPATCH(1) 51 | ``` 52 | -------------------------------------------------------------------------------- /content/latest/Commands/BackgroundExec.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "BackgroundExec" 3 | --- 4 | 5 | Executes a command in the background, similarly to nohup, but without echoing 6 | messages to the console by default, and without appending output to a log file. 7 | 8 | ``` 9 | Syntax: BackgroundExec [options] [arguments] 10 | 11 | Available options are: 12 | -h, --help This help 13 | -v, --verbose Run in verbose mode 14 | ``` 15 | -------------------------------------------------------------------------------- /content/latest/Commands/BootDriver.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "BootDriver" 3 | --- 4 | 5 | The `BootDriver` script should not be run directly from the command line. It is 6 | intended to be specified in the `inittab` file (`/System/Settings/inittab`), to 7 | be launched by process 1, `init`. 8 | 9 | `BootDriver` takes a parameter, indicating which "runlevel" script should be 10 | executed. Here's a sample `inittab` with calls to `BootDriver`: 11 | 12 | ```fish 13 | id:2:initdefault: 14 | 15 | l1:S:wait:/System/Index/bin/BootDriver BootUp 16 | su:S:respawn:/sbin/sulogin 17 | 18 | l2:12345:wait:/System/Index/bin/BootDriver Console 19 | l6:6:wait:/System/Index/bin/BootDriver Reboot 20 | l0:0:wait:/System/Index/bin/BootDriver Halt 21 | 22 | ca:12345:ctrlaltdel:/sbin/shutdown -t1 -r now 23 | 24 | 1:2345:respawn:/System/Index/bin/agetty tty1 9600 25 | 2:2345:respawn:/System/Index/bin/agetty tty2 9600 26 | 3:2345:respawn:/System/Index/bin/agetty tty3 9600 27 | 4:2345:respawn:/System/Index/bin/agetty tty4 9600 28 | 5:2345:respawn:/System/Index/bin/agetty tty5 9600 29 | ``` 30 | -------------------------------------------------------------------------------- /content/latest/Commands/CheckDependants.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "CheckDependants" 3 | --- 4 | 5 | ``` 6 | NAME 7 | CheckDependants - 8 | 9 | SYNOPSIS 10 | CheckDependants [] 11 | 12 | DESCRIPTION 13 | Find which applications is dependant on a given application. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -f, --fast 41 | 42 | Do a fast check - do not cross check result with ldd. 43 | 44 | -s, --specific-version 45 | 46 | Be more specific regarding given version. May miss some applications. 47 | 48 | -m, --include-minors 49 | 50 | Use the version given as base, and include any minor and bug release versions when checking. 51 | 52 | Notes: 53 | If no version is given, current version, or latest version, if no current version is found, is used. 54 | 55 | EXAMPLES 56 | CheckDependants Cairo 1.0.2 57 | 58 | COPYRIGHT 59 | Copyright © 2007 Jonas Karlsson - Released under the GNU GPL. 60 | 61 | GoboLinux March 2017 CHECKDEPENDANTS(1) 62 | ``` 63 | -------------------------------------------------------------------------------- /content/latest/Commands/CleanModules.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "CleanModules" 3 | --- 4 | 5 | ``` 6 | NAME 7 | CleanModules - 8 | 9 | SYNOPSIS 10 | CleanModules 11 | 12 | DESCRIPTION 13 | Clean up all kernel modules that can be removed. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | COPYRIGHT 41 | Copyright © 2003. Released under the GNU GPL. 42 | 43 | GoboLinux March 2017 CLEANMODULES(1) 44 | ``` 45 | -------------------------------------------------------------------------------- /content/latest/Commands/ColorMake.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "ColorMake" 3 | --- 4 | 5 | In default GoboLinux systems, `make` is an alias to `ColorMake`. 6 | 7 | ## Multiple CPUs 8 | 9 | Users on dual-core and similar high-end machines may want to take advantage of 10 | existing CPU capabilities. This can either be done via the MAKEOPTS option or by 11 | modifying the simple ColorMake script. 12 | 13 | At 14 | 15 | ```fish 16 | makecmd= 17 | ``` 18 | 19 | Edit the line to i.e.: 20 | 21 | ```fish 22 | makecmd='/bin/make -j5' 23 | ``` 24 | 25 | About the `-j5` part, the rule of thumb is that the number after `-j` should 26 | equal the number of your cores +1: on a typical dual-core machine, the number 27 | would be 3. 28 | -------------------------------------------------------------------------------- /content/latest/Commands/CommandNotFound.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "CommandNotFound" 3 | --- 4 | 5 | Usage: `CommandNotFound ` 6 | 7 | Intended to be run automatically from shell hooks. 8 | -------------------------------------------------------------------------------- /content/latest/Commands/ContributeRecipe.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "ContributeRecipe" 3 | --- 4 | 5 | ``` 6 | NAME 7 | ContributeRecipe - 8 | 9 | SYNOPSIS 10 | ContributeRecipe { | [] } 11 | 12 | DESCRIPTION 13 | Contribute a recipe to the global store 14 | 15 | OPTIONS 16 | --terse 17 | Enable terse messages. 18 | 19 | --debug 20 | Enable debug messages. 21 | 22 | -h, --help 23 | Show this help. 24 | 25 | --version 26 | Show program version. 27 | 28 | -v, --verbose 29 | Enable verbose mode. 30 | 31 | --logfile 32 | Log all output to specified file. 33 | 34 | -g, --gobo 35 | GoboLinux developer: push straight to repo. 36 | 37 | -p, --pretend 38 | Don't really submit, just dump the report to stdout. 39 | 40 | -s, --show-secret 41 | Show secret GitHub oauth token on stdout. 42 | 43 | EXAMPLES 44 | ContributeRecipe firefox 45 | 46 | COPYRIGHT 47 | Copyright © 2008-2009 Michael Homer, 2020 Rune Morling. Released under the GNU GPL. 48 | 49 | GoboLinux March 2017 CONTRIBUTERECIPE(1) 50 | ``` 51 | 52 | Usage examples: 53 | 54 | ```fish 55 | ContributeRecipe 56 | ``` 57 | 58 | ```fish 59 | ContributeRecipe Bash 60 | ``` 61 | -------------------------------------------------------------------------------- /content/latest/Commands/Corrections.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Corrections" 3 | --- 4 | 5 | ``` 6 | Usage: Corrections [options] 7 | 8 | Options: 9 | -h, --help show this help message and exit 10 | --dir=DIRECTORY take options from DIRECTORY 11 | --log-name=LOG_NAME name to show in log message 12 | --stdin read options from stdin 13 | --threshold=THRESHOLD 14 | leniency in matching 15 | ``` 16 | -------------------------------------------------------------------------------- /content/latest/Commands/DeduceName.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "DeduceName" 3 | --- 4 | 5 | Scan a file to find the capitalization of a program name. 6 | 7 | ## Usage 8 | 9 | ```fish 10 | DeduceName   11 | ``` 12 | 13 | The script scans the given file looking for instances of name, and returns which 14 | is the most frequent capitalization used. 15 | 16 | ## Example 17 | 18 | ```fish 19 | DeduceName README gtkglarea 20 | ``` 21 | -------------------------------------------------------------------------------- /content/latest/Commands/DescribeProgram.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "DescribeProgram" 3 | --- 4 | 5 | ``` 6 | DescribeProgram 7 | Returns the description of the program, if available. 8 | 9 | -Options: 10 | 11 | -a, --update-all downloads all descriptions available at the servers and 12 | cache them locally 13 | 14 | -m, --mode= Output mode: html, terminal or ascii. 15 | 16 | -W, --no-web do not try to download remote descriptions if they are not 17 | locally available 18 | ``` 19 | 20 | Examples of usage: 21 | 22 | ```fish 23 | DescribeProgram gimp 24 | DescribeProgram -W gimp 25 | DescribeProgram -a 26 | ``` 27 | -------------------------------------------------------------------------------- /content/latest/Commands/DetachProgram.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "DetachProgram" 3 | --- 4 | 5 | ``` 6 | NAME 7 | DetachProgram - 8 | 9 | SYNOPSIS 10 | DetachProgram [] [] 11 | 12 | DESCRIPTION 13 | Move a program from /Programs to $goboInstall or . 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -c, --copy 41 | 42 | Copy program. 43 | Keep existing on rootfs. 44 | 45 | -b, --batch 46 | 47 | Batch operation. 48 | Minimize warning output 49 | 50 | -D, --no-dependencies 51 | 52 | Do not try to fulfill dependencies. 53 | 54 | Notes: 55 | This script 'moves' a program from the /Programs hierarchy to directory. Afterwards, symlinks are 56 | created in /Programs to maintain functionality. If is omitted the env var goboInstall is used. 57 | 58 | EXAMPLES 59 | DetachProgram GCC 2.95.3 /Network/Programs 60 | 61 | COPYRIGHT 62 | Copyright © 2004 Carlo Calica. Released under the GNU GPL. 63 | 64 | GoboLinux March 2017 DETACHPROGRAM(1) 65 | ``` 66 | -------------------------------------------------------------------------------- /content/latest/Commands/DisableProgram.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "DisableProgram" 3 | --- 4 | 5 | ``` 6 | NAME 7 | DisableProgram - 8 | 9 | SYNOPSIS 10 | DisableProgram [] 11 | 12 | DESCRIPTION 13 | Unlink a program from the /usr hierarchy. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -u, --unmanaged 41 | 42 | Defines what to do with unmanaged files from package. Valid entries are: 'ask' 'remove' 'keep' 'interactive' 43 | The default value is 'ask'. 44 | 45 | Notes: 46 | This script 'disables' a program in the system, while keeping it in the /Programs hierarchy. To 're-enable' 47 | it, run SymlinkProgram(1) again. If version is not specified, Current is assumed. 48 | 49 | EXAMPLES 50 | DisableProgram GCC 2.95.3 51 | 52 | COPYRIGHT 53 | Copyright © 2003 Hisham Muhammad. Released under the GNU GPL. 54 | 55 | GoboLinux March 2017 DISABLEPROGRAM(1) 56 | ``` 57 | -------------------------------------------------------------------------------- /content/latest/Commands/Docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Docs" 3 | --- 4 | 5 | ``` 6 | NAME 7 | Docs - 8 | 9 | SYNOPSIS 10 | Docs [] [] 11 | 12 | DESCRIPTION 13 | Show the documentation for a program. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -w, --web 41 | 42 | Do not try local docs. Open website directly. 43 | 44 | EXAMPLES 45 | Docs WeirdSuperLib 2.4 46 | 47 | COPYRIGHT 48 | Copyright © Hisham Muhammad, 2017 - Released under the GNU GPL. 49 | 50 | GoboLinux March 2017 DOCS(1) 51 | ``` 52 | -------------------------------------------------------------------------------- /content/latest/Commands/EditRecipe.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "EditRecipe" 3 | --- 4 | 5 | ``` 6 | NAME 7 | EditRecipe - 8 | 9 | SYNOPSIS 10 | EditRecipe [|| [program-version]] 11 | 12 | DESCRIPTION 13 | Fetch a recipe and place it in /Data/Compile/LocalRecipes, chopping its revision number. Calls a text editor on the Recipe file afterwards. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -E, --no-edit 41 | 42 | Do not edit Recipe file, just place the recipe to . 43 | 44 | (C) 2006 Andre Detsch. Released under the GNU GPL. 45 | 46 | GoboLinux March 2017 EDITRECIPE(1) 47 | ``` 48 | -------------------------------------------------------------------------------- /content/latest/Commands/FetchArchive.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "FetchArchive" 3 | --- 4 | 5 | ``` 6 | NAME 7 | FetchArchive - 8 | 9 | SYNOPSIS 10 | FetchArchive [arch-recipe] 11 | 12 | DESCRIPTION 13 | Given a recipe, download the files required to compile it. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -d, --save-directory 41 | 42 | Rename the directory into which the archive is unpacked/files checked out. 43 | 44 | -s, --save-to 45 | 46 | Save the files to the given directory 47 | 48 | -P, --program 49 | 50 | Program name The default value is 'Bash'. 51 | 52 | -V, --version-number 53 | 54 | Version number with revision The default value is '4.0-r1'. 55 | 56 | -b, --batch 57 | 58 | Avoid asking questions. 59 | 60 | EXAMPLES 61 | FetchArchive /K3B/0.10/Recipe 62 | 63 | GoboLinux March 2017 FETCHARCHIVE(1) 64 | ``` 65 | -------------------------------------------------------------------------------- /content/latest/Commands/FilterColors.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "FilterColors" 3 | --- 4 | 5 | ``` 6 | NAME 7 | FilterColors - 8 | 9 | SYNOPSIS 10 | FilterColors 11 | 12 | DESCRIPTION 13 | Filter to monochrome. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | Notes: 41 | Piping output through FilterColors removes terminal escape codes (which usually define color, but may have 42 | other uses). 43 | 44 | EXAMPLES 45 | FilterColors is usually used through a pipe: some_command | FilterColors 46 | 47 | GoboLinux March 2017 FILTERCOLORS(1) 48 | ``` 49 | -------------------------------------------------------------------------------- /content/latest/Commands/FilterLines.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "FilterLines" 3 | --- 4 | 5 | A flexible grep-like tool. 6 | 7 | Examples: 8 | 9 | ```fish 10 | cat foo.txt | Filterlines "bla" 11 | ``` 12 | 13 | shows all lines from `foo.txt` that contain the regexp `bla` 14 | 15 | ```fish 16 | cat foo.txt | Filterlines "bla" "goob" 17 | ``` 18 | 19 | shows all lines from `foo.txt` that contain the regexp `bla` OR the regexp 20 | `goob` 21 | 22 | ```fish 23 | cat foo.txt | Filterlines "bla" "goob" -n "mac" 24 | ``` 25 | 26 | shows all lines from `foo.txt` that contain the regexp `bla` OR the regexp 27 | `goob` but NOT the regexp `mac` 28 | 29 | ```fish 30 | cat foo.txt | Filterlines "bla" "goob" -n "mac" "ops" 31 | ``` 32 | 33 | shows all lines from `foo.txt` that contain the regexp `bla` OR the regexp 34 | `goob` but NEITHER `mac` OR `ops` 35 | 36 | ```fish 37 | cat foo.txt | Filterlines "bla" -n "goob" "mac" "ops" 38 | ``` 39 | 40 | shows all lines from `foo.txt` that contain the regexp `bla` and don't contain 41 | `goob`, `mac` or `ops` 42 | 43 | ```fish 44 | cat foo.txt | Filterlines -n "bla" "goob" "mac" "ops" 45 | ``` 46 | 47 | shows all lines from `foo.txt` that don't contain `bla`, `goob`, `mac` or `ops` 48 | -------------------------------------------------------------------------------- /content/latest/Commands/FindQuick.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "FindQuick" 3 | --- 4 | 5 | ``` 6 | NAME 7 | FindQuick - 8 | 9 | SYNOPSIS 10 | FindQuick [] 11 | 12 | DESCRIPTION 13 | find files. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | Notes: 41 | 42 | if contains "*", it is used directly as an expression for the search. If not, "*" is added to 43 | the beginning and the end. if is not specified, the working directory is assumed. 44 | 45 | EXAMPLES 46 | FindQuick "*.c" .. FindQuick # Note the added quotes to avoid shell expansion. 47 | 48 | GoboLinux March 2017 FINDQUICK(1) 49 | ``` 50 | -------------------------------------------------------------------------------- /content/latest/Commands/FixAttributes.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "FixAttributes" 3 | --- 4 | 5 | ``` 6 | NAME 7 | FixAttributes - 8 | 9 | SYNOPSIS 10 | FixAttributes [options...] files... 11 | 12 | DESCRIPTION 13 | Fix attributes from files based on its contents. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -R, --recursive 41 | 42 | Recurses into subdirectories fixing permissions. 43 | 44 | -t, --true 45 | 46 | Sets permission if file is considered executable. 47 | 48 | -f, --false 49 | 50 | Sets permission if file is considered not executable. 51 | 52 | Notes: 53 | Default permission modes are obtained from FixAttributes.conf. 54 | 55 | COPYRIGHT 56 | Copyright © Hisham Muhammad, 2000-2003 - Released under the GNU GPL. 57 | 58 | GoboLinux March 2017 FIXATTRIBUTES(1) 59 | ``` 60 | -------------------------------------------------------------------------------- /content/latest/Commands/FixDirReferences.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "FixDirReference" 3 | --- 4 | 5 | ``` 6 | NAME 7 | FixDirReferences - 8 | 9 | SYNOPSIS 10 | FixDirReferences 11 | 12 | DESCRIPTION 13 | Converts .{la,pc,cmake} files created by libtool/pkgconfig/cmake to make them GoboLinux-compliant. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -b, --backup 41 | 42 | Keep a backup file of the original files before modifying them. 43 | 44 | EXAMPLES 45 | FixDirReferences -b *.la *.pc *.cmake 46 | 47 | COPYRIGHT 48 | Copyright © Hisham H. Muhammad et al, 2003-2007. Released under the GNU GPL. 49 | 50 | GoboLinux March 2017 FIXDIRREFERENCES(1) 51 | ``` 52 | -------------------------------------------------------------------------------- /content/latest/Commands/FixInfo.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "FixInfo" 3 | --- 4 | 5 | ``` 6 | NAME 7 | FixInfo - 8 | 9 | SYNOPSIS 10 | FixInfo 11 | 12 | DESCRIPTION 13 | Remakes the entries in the info 'dir' file. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -m, --mode 41 | 42 | Operation mode: 'links', 'dir' or 'both'. The default value is 'both'. 43 | 44 | COPYRIGHT 45 | Copyright © 2002-2003 Leandro Motta Barros. Released under the GNU GPL. 46 | 47 | GoboLinux March 2017 FIXINFO(1) 48 | ``` 49 | -------------------------------------------------------------------------------- /content/latest/Commands/GenBuildInformation.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "GenBuildInfo" 3 | --- 4 | 5 | ``` 6 | NAME 7 | GenBuildInformation - 8 | 9 | SYNOPSIS 10 | GenBuildInformation [] 11 | 12 | DESCRIPTION 13 | Generates the list of packages from the current environment used by a GoboLinux package. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -s, --store 41 | 42 | Store the information in Resources/BuildInformation. Default is standard output. 43 | 44 | -a, --all 45 | 46 | Search all files, not just standard directories. 47 | 48 | Notes: 49 | If no version is specified, Current is assumed. 50 | 51 | Released under the GNU GPL. 52 | 53 | GoboLinux March 2017 GENBUILDINFORMATION(1 54 | ``` 55 | -------------------------------------------------------------------------------- /content/latest/Commands/GetAvailable.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "GetAvailable" 3 | --- 4 | 5 | ``` 6 | GetAvailable 7 | Get available packages, recipes and tracked versions. 8 | 9 | 10 | Options: 11 | -t [t1,t2,...] 12 | --types=[t1,t2,...] sets what kind of packages can be searched, in the 13 | passed order. Valid types are: 14 | local_package, official_package, contrib_package, 15 | installed, recipe, tracked, all 16 | using only the first character from any of the above 17 | is also valid: 18 | l, o, c, i, r, t, a 19 | Default types are: 20 | local_package, official_package 21 | notice that when "recipe" type is used, Compile.conf is 22 | read to set recipe-store locations and local recipes 23 | locations. 24 | 25 | --local-dirs=[d1,..] where to look for local binary packages. By default, 26 | uses the paths defined at GetAvailable.conf 27 | 28 | --force-update downloads required packages list even if there is a 29 | local copy (cached in /Data/Variable/tmp/Scripts-jroth/cache/) newer than one hour. 30 | 31 | -W, --no-web do not try to download anything and don't lists 32 | remote recipes and packages (if not explicitly listed 33 | in '--types='). Overrides '--force-update' 34 | 35 | -p 36 | --gobo-programs Override default /Programs as path of installed packages 37 | ``` 38 | 39 | Examples of usage: 40 | 41 | ```fish 42 | GetAvailable --types=recipe 43 | ``` 44 | -------------------------------------------------------------------------------- /content/latest/Commands/GetRecipe.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "GetRecipe" 3 | --- 4 | 5 | ``` 6 | NAME 7 | GetRecipe - 8 | 9 | SYNOPSIS 10 | GetRecipe [|| [program-version]] 11 | 12 | DESCRIPTION 13 | Fetch a recipe and insert it in the recipes tree. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -W, --no-web 41 | 42 | Do not check remote site for recipes. 43 | 44 | (C) 2003-2004 Carlo Calica et al. Released under the GNU GPL. 45 | 46 | GoboLinux March 2017 GETRECIPE(1) 47 | ``` 48 | -------------------------------------------------------------------------------- /content/latest/Commands/GetSupportedFilesystems.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "GetSupportedFilesystems" 3 | --- 4 | 5 | ```fish 6 | sysfs 7 | rootfs 8 | ramfs 9 | bdev 10 | proc 11 | cpuset 12 | cgroup 13 | cgroup2 14 | tmpfs 15 | devtmpfs 16 | binfmt_misc 17 | configfs 18 | debugfs 19 | tracefs 20 | securityfs 21 | sockfs 22 | dax 23 | bpf 24 | pipefs 25 | hugetlbfs 26 | devpts 27 | reiserfs 28 | ext3 29 | ext4 30 | ext2 31 | cramfs 32 | squashfs 33 | iso9660 34 | autofs 35 | overlay 36 | jfs 37 | xfs 38 | pstore 39 | mqueue 40 | btrfs 41 | fuseblk 42 | fuse 43 | fusectl 44 | ``` 45 | -------------------------------------------------------------------------------- /content/latest/Commands/GrepQuick.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "GrepQuick" 3 | --- 4 | 5 | ``` 6 | NAME 7 | GrepQuick - 8 | 9 | SYNOPSIS 10 | GrepQuick [] 11 | 12 | DESCRIPTION 13 | Shorthand for 'grep'. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -r, --recursive 41 | 42 | Recursive. 43 | 44 | -w, --whole-word 45 | 46 | Match whole words only. 47 | 48 | -C, --no-color 49 | 50 | Avoid coloring (for grep's that don't support it). 51 | 52 | -b, --binaries 53 | 54 | Also search binary files. 55 | 56 | Notes: 57 | 58 | Search is case sensitive only if there is at least one uppercase character in the pattern. Binary files are not 59 | searched unless --binaries is given. Error messages are not displayed. Line numbers are displayed. If no files are 60 | specified, all files are selected (except in "source" mode, where *.[CcHh]* is selected instead). 61 | 62 | COPYRIGHT 63 | Copyright © 2001-2002 Hisham Muhammad. Released under the GNU GPL. 64 | 65 | GoboLinux March 2017 GREPQUICK(1) 66 | ``` 67 | -------------------------------------------------------------------------------- /content/latest/Commands/GrepReplace.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "GrepReplace" 3 | --- 4 | 5 | ``` 6 | NAME 7 | GrepReplace - 8 | 9 | SYNOPSIS 10 | GrepReplace 11 | 12 | DESCRIPTION 13 | Swaps occurrences of a regex for another word in a series of files. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -R, --recursive 41 | 42 | Perform change recursively in all files (overrides last parameter). 43 | 44 | -B, --no-backup 45 | 46 | Do not create backup copies of the original files. 47 | 48 | EXAMPLES 49 | GrepReplace "SimMcast" "simmcast" *.java 50 | 51 | COPYRIGHT 52 | Copyright © 2000-2003 Hisham Muhammad - Released under the GNU GPL. 53 | 54 | GoboLinux March 2017 GREPREPLACE(1) 55 | ``` 56 | -------------------------------------------------------------------------------- /content/latest/Commands/GuessLatest.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "GuessLatest" 3 | --- 4 | 5 | ``` 6 | Usage: GuessLatest [-s] [version2] ... 7 | Accepts package names, recipe names or version numbers as parameter 8 | 9 | Options: 10 | -h, --help show this help message and exit 11 | -s, --stable try to return a stable version as result 12 | -l, --list returns a sorted list of versions 13 | ``` 14 | -------------------------------------------------------------------------------- /content/latest/Commands/GuessProgramCase.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "GuessProgramCase" 3 | --- 4 | 5 | ``` 6 | NAME 7 | GuessProgramCase - 8 | 9 | SYNOPSIS 10 | GuessProgramCase [] 11 | 12 | DESCRIPTION 13 | Try to guess the case of a program based on the installed packages. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | Notes: 41 | If no version is specified, Current is assumed. 42 | 43 | (C)2003-2007 by Andre Detsch et al. Released under the GNU GPL. 44 | 45 | GoboLinux March 2017 GUESSPROGRAMCASE(1) 46 | ``` 47 | -------------------------------------------------------------------------------- /content/latest/Commands/Hashes.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Hashes" 3 | --- 4 | 5 | ``` 6 | NAME 7 | Hashes - 8 | 9 | SYNOPSIS 10 | Hashes { [-c] [] } 11 | 12 | DESCRIPTION 13 | Manages FileHash and FileHash.sig in a GoboLinux package. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -c, --check 41 | 42 | check the package's dependency file 43 | 44 | -s, --sign 45 | 46 | Generate, then sign the hash file 47 | 48 | -g, --generate 49 | 50 | Generate the hash file. 51 | 52 | -l, --list 53 | 54 | List hash file, if any (generate if not present). 55 | 56 | -u, --local-user 57 | 58 | Use as the user ID to sign with. 59 | 60 | -r, --keyring 61 | 62 | GPG option to an additional the keyring location. 63 | 64 | Notes: 65 | If no version is specified, Current is assumed. 66 | 67 | COPYRIGHT 68 | Copyright © 2003 Carlo Calica. Released under the GNU GPL. 69 | 70 | GoboLinux March 2017 HASHES(1) 71 | ``` 72 | -------------------------------------------------------------------------------- /content/latest/Commands/Installer.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Installer" 3 | --- 4 | 5 | Installer is a program included on the LiveCD to install GoboLinux to your hard 6 | drive. It takes care of basic configuration, package selection, and boot loader 7 | setup. Installer uses a common framework for command-line and GUI interfaces. 8 | 9 | - [Installing GoboLinux]({{%relref "Installing-Gobolinux" %}}) 10 | -------------------------------------------------------------------------------- /content/latest/Commands/IsExecutable.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "IsExecutable" 3 | --- 4 | 5 | Returns 0 (success) if the file looks like a Linux executable (starting with a 6 | hash-bang magic or an ELF header), or 1 (failure) otherwise. 7 | 8 | This helper is used by the [FixAttributes](../FixAttributes) script. 9 | -------------------------------------------------------------------------------- /content/latest/Commands/KeyManager.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "KeyManager" 3 | --- 4 | 5 | Manage digital signature keys for GoboLinux packages. 6 | 7 | ``` 8 | Usage: KeyManager [ ] 9 | 10 | Options: 11 | 12 | -h, --help Shows this help. 13 | 14 | -v, --version Show program version. 15 | 16 | -V, --verbose Enable verbose mode. 17 | 18 | -i, --import Import key 19 | 20 | -l, --list List public keys 21 | ``` 22 | -------------------------------------------------------------------------------- /content/latest/Commands/MergeTree.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "MergeTree" 3 | --- 4 | 5 | ``` 6 | NAME 7 | MergeTree - 8 | 9 | SYNOPSIS 10 | MergeTree 11 | 12 | DESCRIPTION 13 | Mirrors one directory structure into another. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -d, --delete 41 | 42 | On conflicts, overwrite original file. 43 | 44 | Notes: 45 | All files and directories in appear as symbolic links in 46 | 47 | EXAMPLES 48 | MergeTree /Programs/KOffice/Current /Programs/KDE/Current 49 | 50 | GoboLinux March 2017 MERGETREE(1) 51 | ``` 52 | -------------------------------------------------------------------------------- /content/latest/Commands/NamingConventions.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "NamingConventions" 3 | --- 4 | 5 | ``` 6 | NAME 7 | NamingConventions - 8 | 9 | SYNOPSIS 10 | NamingConventions 11 | 12 | DESCRIPTION 13 | Heuristics to determine a capitalized, GoboLinux-like name. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | GoboLinux March 2017 NAMINGCONVENTIONS(1) 41 | ``` 42 | 43 | Note that NamingConventions is part of the `Scripts` package. You can find in 44 | the `bin/` subdirectory there. 45 | 46 | Here are some usage examples; note that presently `NamingConventions` appears to 47 | prefer only the program name, so if you have a full remote URL, make sure to 48 | only pass the name of the program towards `NamingConventions`. 49 | 50 | ```fish 51 | NamingConventions glib => GLib 52 | ``` 53 | -------------------------------------------------------------------------------- /content/latest/Commands/PackRecipe.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "PackRecipe" 3 | --- 4 | 5 | ``` 6 | NAME 7 | PackRecipe - 8 | 9 | SYNOPSIS 10 | PackRecipe [ []] 11 | 12 | DESCRIPTION 13 | Generate "packed recipes", ready for submission. 14 | 15 | OPTIONS 16 | --terse 17 | 18 | Enable terse messages. 19 | 20 | --debug 21 | 22 | Enable debug messages. 23 | 24 | -h, --help 25 | 26 | Show this help. 27 | 28 | --version 29 | 30 | Show program version. 31 | 32 | -v, --verbose 33 | 34 | Enable verbose mode. 35 | 36 | --logfile 37 | 38 | Log all output to specified file. 39 | 40 | -L, --no-lint 41 | 42 | Do not verify recipes (not recommended). 43 | 44 | -W, --no-web 45 | 46 | Offline operation when running RecipeLint (avoid if possible). 47 | 48 | Notes: 49 | Given no arguments, this script will take all recipes in 50 | and pack them as Foo--1.0--recipe.tar.bz2 files at . 51 | 52 | (C) 2003-2004 Carlo Calica et al. Released under the GNU GPL. 53 | 54 | GoboLinux March 2017 PACKRECIPE(1) 55 | ``` 56 | -------------------------------------------------------------------------------- /content/latest/Commands/PrioritiseUpdates.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "PrioritizeUpdates" 3 | --- 4 | 5 | Usage: 6 | 7 | ``` 8 | /usr/bin/PrioritiseUpdates 9 | ``` 10 | -------------------------------------------------------------------------------- /content/latest/Commands/RebuildLinks.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "RebuildLinks" 3 | --- 4 | 5 | Rebuild `/System/Index directories`. 6 | 7 | ``` 8 | Usage: RebuildLinks