REBASE(1)							     REBASE(1)



NAME
       rebase - a pacman database synchronization tool


SYNOPSIS
       rebase [options] [repos]


DESCRIPTION
       Rebase  is  a  pacman  database	synchronization	 tool.	It  is able to
       retrieve the database archives for repos listed in a pacman  configura‐
       tion file and selectively extract the files. Rebase uses parallel down‐
       loads to speed up retrieval and pipes to keep everything in memory dur‐
       ing  a sync operation. It only writes files to the disk when necessary.
       This is in contrast to pacman which deletes and recreates all files  in
       each database with every update, leading to unnecessary IO operations.

       The  output  during  a sync operation will show you exactly which files
       have been added and will alert you about any errors such as failing  to
       retrieve	 a  database  from  a  given  URL.  By	default, rebase parses
       /etc/pacman.conf to get a list of servers for each repo and it respects
       the order just as pacman does.

       Rebase is also able to download databases for other architectures which
       may be useful when installing a system remotely or when	configuring  a
       chroot environment.

       Finally,	 rebase	 only updates the sync databases. It never touches the
       local database so it should be completely safe to use.  Even  if	 some‐
       thing  were  to	happen to your sync database, rebase should be able to
       fix it. In the worst case scenario, rebase has a "--reset" option  will
       will use pacman to force a database refresh, overwriting all files with
       a fresh database.



USAGE
       rebase [options] [repos]

       If no repos are specified, all repos are used.


OPTIONS
       --arch, -a <architecture>
	      Retrieve databases for this architecture.


       --by-lastupdate
	      Only download databases which appear to be newer than  the  time
	      reported in the ".lastupdate" file.


       --dbpath, -b <path>
	      Change the database path.


       --dir, -d <path>
	      Change  the  output  directory.  This  applies to the "--get-ar‐
	      chives" option.


       --get-archives
	      Download the database archive files.


       --help, -h
	      Display the help message and exit.


       --log <path>
	      Enable logging.


       --man  Display the man page and exit.


       --man-nroff
	      Display the man page in nroff format and exit.


       --no-color
	      Suppress colored output.


       --overwrite
	      Overwrite existing database files. This is what Pacman  does  by
	      default.


       --pacman-config <path>
	      Use a different pacman configuration file.


       --silent
	      Suppress all output.




AUTHORS
       Xyne




				 January 2010			     REBASE(1)