apkg.8 (4786B)
1 .\" -*- mode: troff; coding: utf-8 -*- 2 .TH "" "8" "" 3 .SH NAME 4 .SH DESCRIPTION 5 .LP 6 \fBapkg\fR is the package build tool and package installer, along with \fBspm\fR for the alice linux distribution. 7 It is written in posix shell with the goal to be simple and effective. It can consume package building templates in the abuild format 8 and automate the building and installing of packages. 9 .SH OPTIONS 10 .LP 11 Arguments for apkg are as follows: 12 .IP "\(bu" 3 13 \fB-h\fR Print help. 14 .if n \ 15 .sp -1 16 .if t \ 17 .sp -0.25v 18 .IP "\(bu" 3 19 \fB-i\fR \fI\fR Install package(s) without taking dependencies into account. Building will fail if the dependencies are not present in the system. 20 .if n \ 21 .sp -1 22 .if t \ 23 .sp -0.25v 24 .IP "\(bu" 3 25 \fB-I\fR \fI\fR Install package(s) with dependencies. 26 .if n \ 27 .sp -1 28 .if t \ 29 .sp -0.25v 30 .IP "\(bu" 3 31 \fB-d\fR \fI\fR List only direct package dependencies 32 .if n \ 33 .sp -1 34 .if t \ 35 .sp -0.25v 36 .IP "\(bu" 3 37 \fB-D\fR \fI\fR List all dependencies for package(s) 38 .if n \ 39 .sp -1 40 .if t \ 41 .sp -0.25v 42 .IP "\(bu" 3 43 \fB-j\fR \fI\fR List all reverse dependencies for the package (packages that depend on it). 44 .if n \ 45 .sp -1 46 .if t \ 47 .sp -0.25v 48 .IP "\(bu" 3 49 \fB-u\fR \fI\fR Upgrade package(s) 50 .if n \ 51 .sp -1 52 .if t \ 53 .sp -0.25v 54 .IP "\(bu" 3 55 \fB-r\fR \fI\fR Remove package(s) 56 .if n \ 57 .sp -1 58 .if t \ 59 .sp -0.25v 60 .IP "\(bu" 3 61 \fB-t\fR \fI\fR Run scripts for package(s) that update cache or dbs (mime, font cache e.t.c) 62 .if n \ 63 .sp -1 64 .if t \ 65 .sp -0.25v 66 .IP "\(bu" 3 67 \fB-U\fR Update system 68 .if n \ 69 .sp -1 70 .if t \ 71 .sp -0.25v 72 .IP "\(bu" 3 73 \fB-f\fR Force rebuild a package. 74 .if n \ 75 .sp -1 76 .if t \ 77 .sp -0.25v 78 .IP "\(bu" 3 79 \fB-o\fR \fI\fR Only download source for package(s), do not build and install 80 .if n \ 81 .sp -1 82 .if t \ 83 .sp -0.25v 84 .IP "\(bu" 3 85 \fB-p\fR \fI\fR Print full path to the package build template directory 86 .if n \ 87 .sp -1 88 .if t \ 89 .sp -0.25v 90 .IP "\(bu" 3 91 \fB-s\fR \fI\fR Search for packages 92 .if n \ 93 .sp -1 94 .if t \ 95 .sp -0.25v 96 .IP "\(bu" 3 97 \fB-g\fR \fI\fR Update or generate checksum(s) for the package source files. 98 .SH ENVIRONMENT VARIABLES 99 .IP "\(bu" 3 100 \f(CRAPKG_ROOT\fR Overrides default root location (/), where sw is installed 101 .if n \ 102 .sp -1 103 .if t \ 104 .sp -0.25v 105 .IP "\(bu" 3 106 \f(CRAPKG_CONF\fR Overrides default location for the configuration file apkg.conf. The default is under /etc on an installed alice linux system. 107 .if n \ 108 .sp -1 109 .if t \ 110 .sp -0.25v 111 .IP "\(bu" 3 112 \f(CRAPKG_NOPROMPT\fR If set, it enabled non-interactive use by disabling user confirmation prompt. 113 .if n \ 114 .sp -1 115 .if t \ 116 .sp -0.25v 117 .IP "\(bu" 3 118 \f(CRAPKG_REPO\fR Double-quoted, space-separated list for the local directories that contain build templates. 119 .if n \ 120 .sp -1 121 .if t \ 122 .sp -0.25v 123 .IP "\(bu" 3 124 \f(CRAPKG_PACKAGE_DIR\fR Directory where the compiled packages will reside. 125 .if n \ 126 .sp -1 127 .if t \ 128 .sp -0.25v 129 .IP "\(bu" 3 130 \f(CRAPKG_SOURCE_DIR\fR Directory that will hold the downloaded sources. 131 .if n \ 132 .sp -1 133 .if t \ 134 .sp -0.25v 135 .IP "\(bu" 3 136 \f(CRAPKG_WORK_DIR\fR Directory where the actual building process will take place. This happens in subdirectories which are cleaned after completion. 137 .if n \ 138 .sp -1 139 .if t \ 140 .sp -0.25v 141 .IP "\(bu" 3 142 \f(CRAPKG_LOG\fR If set, it enables the creation of a log for the program output. 143 .LP 144 \fBNote:\fR Usually, APKG\fIREPO, APKG\fRPACKAGE\fIDIR, APKG\fRSOURCE\fIDIR and APKG\fRWORK_DIR are declared in the apkg.conf configuration file. For more information, please see apkg.conf(5). 145 .SH FILES 146 .IP "\(bu" 3 147 \fBapkg.conf(5)\fR is the default configuration file, it resides by default under /etc. 148 .if n \ 149 .sp -1 150 .if t \ 151 .sp -0.25v 152 .IP "\(bu" 3 153 \fBabuild\fR is the name of the package templates that apkg uses, along with relevant files in order to 154 build and installed packages. For example, one can look to the alice linux repos, under \c 155 .UR https://codeberg.org/emmett1/alicelinux/src/branch/main/repos 156 .UE 157 .SH EXAMPLES 158 .LP 159 \f(CRapkg -i linux\fR - Install the \fIlinux\fR package 160 .PP 161 \f(CRapkg -f jupp\fR - Force rebuild the \fIjupp\fR package. If someone tries with just \f(CR-i\fR, \f(CRapkg\fR will produce the following message 162 if the package is already installed: \f(CR[...] Package 'jupp' already installed.\fR 163 .PP 164 \f(CRapkg -s icon\fR - Search for packages names that contain \(lqicon\(rq, it will produce a list with one 165 package per line. 166 .SH AUTHORS 167 .LP 168 emmett1 \c 169 .MT emmett1.2miligrams@protonmail.com 170 .ME 171 Author of the program and creator of alice linux. 172 .PP 173 mobinmob \c 174 .MT mobinmob@disroot.org 175 .ME 176 Author of the man page. 177 .SH REPORTING BUGS 178 .LP 179 \fBapkg\fR is in a working stage but also under heavy development. Please report and bugs/issues in the project issue tracker: \c 180 .UR https://codeberg.org/emmett1/autils/issues 181 .UE