man1/aur-repo.1

   1 .TH AUR-REPO 1 2022-03-12 AURUTILS
   2 .SH NAME
   3 aur\-repo \- manage local repositories
   4 .
   5 .SH SYNOPSIS
   6 .SY "aur repo"
   7 .OP \-\-list
   8 .OP \-\-table
   9 .OP \-\-upgrades
  10 .SY "aur repo"
  11 .OP \-c file
  12 .OP \-d name
  13 .OP \-r path
  14 .OP \-F field
  15 .OP \-aqS
  16 .YS
  17 .
  18 .SH DESCRIPTION
  19 .B aur\-repo
  20 helps manage local
  21 .RI ( file:// )
  22 .BR pacman (8)
  23 repositories. In particular, it serves to parse repository contents
  24 .RI ( \-\-list ", " \-\-table ),
  25 compare package versions to the AUR
  26 .RI ( \-\-upgrades ),
  27 and list local repository file paths
  28 .RI ( \-\-list\-path ).
  29 .PP
  30 If
  31 .BR pacman.conf (5)
  32 contains only a single local repository,
  33 .B aur\-repo
  34 selects it automatically. If multiple local repositories are
  35 configured, they must specified explicitely with the
  36 .BR \-d option.
  37 .
  38 .SH OPERATIONS
  39 .TP
  40 .BI \-F " FIELD" "\fR,\fP \-\-field=" FIELD
  41 List the attribute
  42 .I FIELD
  43 for all packages in the local repository. May be one of
  44 .BR filename ,
  45 .BR name ,
  46 .BR base ,
  47 .BR version ,
  48 .BR desc ,
  49 .BR url ,
  50 .BR license ,
  51 .BR arch ,
  52 .BR builddate ,
  53 .BR packager ,
  54 .BR conflicts ,
  55 .BR provides ,
  56 .BR depends ,
  57 .BR makedepends ,
  58 .BR optdepends ,
  59 or any other valid fields generated by
  60 .BR repo\-add (1).
  61 .
  62 .TP
  63 .BR \-l ", " \-\-list
  64 List the contents of a local repository in the following format:
  65 .IP
  66 .BI pkgname \et pkgver \en
  67 .
  68 .TP
  69 .BR \-t ", " \-\-table
  70 List the contents of a local repository in the following format:
  71 .IP
  72 .BI pkgname \et depends \et pkgbase \et pkgver \en\c
  73 \&.
  74 .IP
  75 If a package has no dependencies
  76 .B pkgname
  77 is used as
  78 .BR depends ,
  79 otherwise missing values are represented by
  80 .IR \- .
  81 See also
  82 .BR \-\-table
  83 in
  84 .BR aur\-depends (1)
  85 .
  86 .TP
  87 .BR \-u ", " \-\-upgrades
  88 Check package updates with
  89 .BR aur\-vercmp (1)
  90 .
  91 .TP
  92 .BR \-\-list\-path
  93 List the paths of configured local repositories.
  94 .
  95 .TP
  96 .BR \-\-list\-repo
  97 List the names of configured local repositories.
  98 .
  99 .TP
 100 .BR \-\-path
 101 List the resolved path of the selected
 102 .BR pacman (8)
 103 repository.
 104 .
 105 .SH OPTIONS
 106 .TP
 107 .BI \-c " FILE" "\fR,\fP \-\-config=" FILE
 108 Specify an alternate
 109 .BR pacman (8)
 110 configuration file.
 111 .
 112 .TP
 113 .BI \-d " NAME" "\fR,\fP \-\-database=" NAME
 114 The name of a
 115 .BR pacman (8)
 116 repository.
 117 .IP
 118 The repository should have a
 119 .B file://
 120 location, or any other location when using
 121 .BR \-\-sync .
 122 .
 123 .TP
 124 .BI \-r " PATH" "\fR,\fP \-\-root=" PATH
 125 The path to the root of a local repository.
 126 .
 127 .TP
 128 .BR \-a ", " \-\-all
 129 Use
 130 .B "aur\-vercmp \-\-all"
 131 when checking for upgrades. Implies
 132 .BR \-\-upgrades .
 133 .
 134 .TP
 135 .BR \-q ", " \-\-quiet
 136 Only print package names when listing the repository
 137 .RB ( \-\-list )
 138 or checking for upgrades
 139 .RB ( \-\-upgrades ).
 140 .
 141 .TP
 142 .BR \-S ", " \-\-sync
 143 Query repositories in
 144 .BI DBPATH /sync
 145 (defaults to
 146 .BR /var/lib/pacman/sync )
 147 instead of by their
 148 .B file://
 149 path.
 150 .
 151 .TP
 152 .BI \-\-status\-file= FILE
 153 Print status information to a specified file, in the following format:
 154 .IP
 155 .RS
 156 .EX
 157 .PP
 158 repo:<repository name>
 159 root:<root of repository>
 160 path:<path of repository>
 161 .PP
 162 .EE
 163 Can be combined with other operations.
 164 .RE
 165 .
 166 .SH EXAMPLES
 167 List information on configured local repositories:
 168 .PP
 169 .EX
 170   $ aur repo --repo-list | while read -r repo; do
 171         printf '[%s]\\n' "$repo"
 172         pacconf --repo="$repo"
 173     done
 174 .EE
 175 .PP
 176 .
 177 .SH ENVIRONMENT
 178 .TP
 179 .B AUR_REPO
 180 The name of a pacman repository, see
 181 .BR \-d .
 182 .
 183 .TP
 184 .B AUR_DBROOT
 185 The path to the root of a local repository, see
 186 .BR \-r .
 187 .
 188 .SH SEE ALSO
 189 .ad l
 190 .nh
 191 .BR aur (1),
 192 .BR aur\-depends (1),
 193 .BR aur\-vercmp (1),
 194 .BR pacman.conf (5),
 195 .BR pacman (8)
 196 .
 197 .SH AUTHORS
 198 .MT https://github.com/AladW
 199 Alad Wenter
 200 .ME
 201 .
 202 .\" vim: set textwidth=72: