.TH "EMERGE" "1" "Jun 2003" "Portage 2.0.51" "Portage" .SH "NAME" emerge \- Command\-line interface to the Portage system .SH "SYNOPSIS" .TP .BR emerge [\fIoptions\fR] [\fIaction\fR] [\fIebuild\fR | \fItbz2file\fR | \fIclass\fR | \fIdependency\fR] ... .TP .BR emerge \fB\-\-sync\fR | \fB\-\-info\fR | \fB\-\-version\fR .TP .BR emerge \fB\-\-search\fR \fIsomestring\fR .TP .BR emerge \fB\-\-help\fR [\fBsystem\fR | \fBconfig\fR | \fBsync\fR] .SH "DESCRIPTION" \fBemerge\fR is the definitive command\-line interface to the Portage system. It is primarily used for installing packages, and \fBemerge\fR can automatically handle any dependencies that the desired package has. \fBemerge\fR can also update the \fBportage tree\fR, making new and updated packages available. \fBemerge\fR gracefully handles updating installed packages to newer releases as well. It handles both source and binary packages, and it can be used to create binary packages for distribution. .SH "EBUILDS, TBZ2S, CLASSES AND DEPENDENCIES" \fBemerge\fR primarily installs packages. You can specify packages to install in one of four main ways: an \fIebuild\fR, a \fItbz2file\fR, a \fIclass\fR, or a \fIdependency\fR. .LP .TP .BR ebuild An \fIebuild\fR must be, at a minimum, a valid Portage package directory name without a version or category, such as \fBportage\fR or \fBpython\fR. Both categories and version numbers may be used in addition, such as \fBsys\-apps/portage\fR or \fB=python\-2.2.1\-r2\fR. \fBemerge\fR ignores a trailing slash so that filename completion can be used. The \fIebuild\fR may also be an actual filename, such as \fB/usr/portage/app\-admin/python/python\-2.2.1\-r2.ebuild\fR. WARNING: The implementation of \fBemerge /path/to/ebuild\fR is broken and so this syntax shouldn't be used. .TP .BR tbz2file A \fItbz2file\fR must be a valid .tbz2 created with \fBebuild \-.ebuild package\fR or \fBemerge \-\-buildpkg [category/]\fR or \fBquickpkg /var/db/pkg//\fR. .TP .BR class Package classes are a convenient shorthand for large groups of packages. Two classes are currently supported: \fBsystem\fR and \fBworld\fR. \fBsystem\fR refers to a set of packages deemed necessary for your system to run properly. \fBworld\fR contains all of the packages in \fBsystem\fR, along with any other packages listed in \fB/var/lib/portage/world\fR. [See \fBFILES\fR below for more information.] Note that these commands are generally used in conjunction with \fB\-\-update\fR. .TP .BR dependency A \fIdependency\fR describes bounds on a package that you wish to install. \fISee portage(5) for the details on these 'atoms'.\fR For example, \fB>=dev\-lang/python\-2.2.1\-r2\fR matches the latest available version of Python greater than or equal to 2.2.1\-r2. Similarly, \fB .br Geert Bevin .br Achim Gottinger .br Nicholas Jones .br Phil Bordelon .br Mike Frysinger .br Marius Mauch .br .SH "CVS HEADER" $Header: /var/cvsroot/gentoo-src/portage/man/emerge.1,v 1.70.2.15 2005/08/20 03:56:50 vapier Exp $