aboutsummaryrefslogtreecommitdiff
path: root/man
Commit message (Collapse)AuthorAgeFilesLines
* man/emerge.1: fix logrotate directory containing elog-save-summaryChris Mayo2020-03-141-1/+1
| | | | | Signed-off-by: Chris Mayo <aklhfex@gmail.com> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Rename PORTAGE_LOG_FILTER_FILE_CMD from PORTAGE_LOG_FILTER_FILEZac Medico2020-03-021-1/+1
| | | | | | Suggested-by: Michael 'veremitz' Everitt <gentoo@veremit.xyz> Bug: https://bugs.gentoo.org/709746 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Support PORTAGE_LOG_FILTER_FILE (bug 709746)Zac Medico2020-02-291-1/+6
| | | | | | | | | | | | | | This variable specifies a command that filters build log output to a log file. The plan is to extend this to support a separate filter for tty output in the future. In order to enable the EbuildPhase class to write elog messages to the build log with PORTAGE_LOG_FILTER_FILE support, convert its _elog method to a coroutine, and add a SchedulerInterface async_output method for it to use. Bug: https://bugs.gentoo.org/709746 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Support FEATURES=qa-unresolved-soname-deps (bug 708448)Zac Medico2020-02-081-0/+4
| | | | | | | | | | | | Support FEATURES=qa-unresolved-soname-deps so that it's possible to disable the QA warning that was introduced for bug 704320. This is useful for systems that may have incomplete PROVIDES metadata due to alternative package managers or experimentation with a new architecture. Bug: https://bugs.gentoo.org/708448 Bug: https://bugs.gentoo.org/704320 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Include the category when we suggest running "emerge ... portage"Mike Gilbert2020-01-311-2/+2
| | | | | | | | This will prevent problems if another package named "portage" is added in another category. Signed-off-by: Mike Gilbert <floppym@gentoo.org> Reviewed-by: Zac Medico <zmedico@gentoo.org>
* Clean up remnants of eapi5-hdepend, HDEPEND and targetrootMichał Górny2019-12-261-6/+4
| | | | | | Reviewed-by: Zac Medico <zmedico@gentoo.org> Closes: https://github.com/gentoo/portage/pull/490 Signed-off-by: Michał Górny <mgorny@gentoo.org>
* emerge: drop FEATURES=distcc-pump support, bug #702146Sergei Trofimovich2019-12-081-3/+0
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | 'distcc' distributes code generation for preprocessed files. 'pump' distributes preprocessing and code generation of files and imposes very strict requirement: """ Note that distcc's pump-mode assumes that sources files will not be modified during the lifetime of the include server, so modifying source files during a build may cause inconsistent results. """ `src_configure()` (where we used to start include server before this change) almost always violates that requirement. It is not uncommon to generate more intermediate source files as a package builds (`bison`, `flex`, child `./configure` calls from `make`) and thus quite unsafe to use `pump`. This change drops `FEATURES=distcc-pump` and leaves only FEATURES=distcc. This way all the proprocessing happens as expected and only code generation is offloaded. Bug: https://bugs.gentoo.org/702146 Signed-off-by: Sergei Trofimovich <slyfox@gentoo.org> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* emerge: add --implicit-system-deps <y|n> option (bug 681312)Zac Medico2019-12-051-0/+7
| | | | | | | | | | | | Assume that packages may have implicit dependencies on packages which belong to the @system set. This option is enabled by default. One of the effects of disabling this option is to allow the --jobs option to spawn jobs without accounting for the possiblity of implicit dependencies on packages that belong to the @system set (this causes the @system set to behave more like the @profile set). Bug: https://bugs.gentoo.org/681312 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* emerge: add --quickpkg-direct optionZac Medico2019-11-261-1/+18
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Enable use of installed packages directly as binary packages. This is similar to using binary packages produced by quickpkg(1), but installed packages are used directly as though they are binary packages. This option only works in combination with the --root=DIR option, and it comes with the caveat that packages are only allowed to be installed into the root that is specified by the --root=DIR option. The other root which serves as a source of packages is assumed to be immutable during the entire operation (similar to --buildpkgonly mode). Default behavior for handling of protected configuration files is controlled by the QUICKPKG_DEFAULT_OPTS variable. When a configuration file is not included because it is protected, an ewarn message is logged. Suggested use cases: * Install packages from a buildtime container into an empty root, in order to create a minimal runtime container (which need not include a package manager). In a multi-stage Dockerfile, install runtime files to an empty directory in the build stage, and in the final stage use COPY to populate a container with the contents of that directory. For greater efficiency, use buildah to install directly into a mounted container, avoiding the COPY step. Use the emerge --usepkgonly and --ignore-soname-deps=n options to account for soname dependencies, allowing implicit system dependencies such as glibc to be automatically pulled into the runtime image. * Enable a live usb, iso, or pxe image to act as a binary installer that uses packages installed in the live image as a source of binary packages. Bug: https://bugs.gentoo.org/699986 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* man/emerge.1: fix \fB typoZac Medico2019-11-261-1/+1
| | | | | | | $ groff -man man/emerge.1 >/dev/null man/emerge.1:117: warning: can't find font `b' Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Rename DCO_SIGNED_OFF_BY config variable to SIGNED_OFF_BY.Ulrich Müller2019-11-261-3/+10
| | | | | | | | Provide compatibility support for old name. Update make.conf.5 man page. Bug: https://bugs.gentoo.org/667432 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* man/make.conf.5: fix \fI typoZac Medico2019-11-211-1/+1
| | | | | | | | | $ groff -man man/make.conf.5 >/dev/null man/make.conf.5:15: warning: can't find font `L' Reported-by: Ulrich Müller <ulm@gentoo.org> Fixes: b5365341dad1 ("refresh many URIs in the code base") Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Default disable autounmask package.accept_keywords/mask changes (bug 658648)Zac Medico2019-10-141-4/+19
| | | | | | | | | | | | Add emerge --autounmask-license and --autounmask-use options which are enabled by default, and disable package.accept_keywords/mask changes by default. For backward compatibility, previous behavior of --autounmask=y and --autounmask=n is entirely preserved. Users can get the old behavior simply by adding --autounmask to the make.conf EMERGE_DEFAULT_OPTS variable. Bug: https://bugs.gentoo.org/658648 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* man/emirrordist.1: document new optionsMichał Górny2019-10-121-0/+10
| | | | | Reviewed-by: Zac Medico <zmedico@gentoo.org> Signed-off-by: Michał Górny <mgorny@gentoo.org>
* man/ebuild.5: Improvements to the ebuild(5) man pageDaniel Robbins2019-09-291-44/+116
| | | | | | | | | | | | | | | | The following patch contains several formatting improvements, as well as extended information about KEYWORDS that is easier to understand. The original description started describing Gentoo policy on KEYWORDS without actually explaining what they are and how they work. I have also added missing documentation for the ARCH variable as this was sort of shoe-horned in to the KEYWORDS documentation, and tried to make it clearer what is a technical requirement of Portage the software and what are Gentoo-specific arch team requirements. Bug: https://bugs.gentoo.org/695870 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* make.conf: clarify distlocks usageMike Frysinger2019-09-111-2/+6
| | | | | | | | The current text makes it sound like distlocks control mutual access in more scenarios than it actually does. Clarify that it only shows up for distfiles & binpkgs. Signed-off-by: Mike Frysinger <vapier@gentoo.org>
* man/glsa-check.1: fix man2html formattingZac Medico2019-09-011-44/+21
| | | | Signed-off-by: Zac Medico <zmedico@gentoo.org>
* glsa-check: update man page with -r optionAaron Bauman2019-09-011-4/+4
| | | | | | | Also remove duplicate --quiet documentation. Signed-off-by: Aaron Bauman <bman@gentoo.org> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* man/glsa-check.1: remove deprecated "new" targetZac Medico2019-08-311-1/+1
| | | | | | | | The "new" target was remove in 82797924dcc6dbfcca22067633cd160ead1199a7. Fixes: b8cc6a4cd999 ("man/glsa-check.1: update the glsa-check man page") Reported-by: Aaron Bauman <bman@gentoo.org> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* emerge: deprecate --changelog option (bug 693096)Zac Medico2019-08-301-0/+2
| | | | | | | | The emerge --changelog option is not very useful since the gentoo repository no longer includes ChangeLog files. Bug: https://bugs.gentoo.org/693096 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Add FEATURES=pkgdir-index-trustedZac Medico2019-08-301-0/+8
| | | | | | | | | | | | Trust that the PKGDIR index file is valid, meaning that no packages have been manually added or removed since the last call to emaint --fix binhost. This feature eliminates overhead involved with detection of packages that have been manually added or removed, which significantly improves performance in some cases, such as when PKGDIR resides on a high-latency network file system. Bug: https://bugs.gentoo.org/688902 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* glsa-check: add man page exit valuesAaron Bauman2019-08-301-0/+12
| | | | | | | | Bug: https://bugs.gentoo.org/587930 Reported-by: Bandie Yip Kojote <bandie@ttygap.net> Signed-off-by: Aaron Bauman <bman@gentoo.org> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* glsa-check: Add --quiet optionZac Medico2019-08-291-0/+3
| | | | | | | | | | | | | | | | | | | | | | | This patch is a forward port of the following commit: https://gitweb.gentoo.org/proj/gentoolkit.git/commit/?id=cd5a8e80f949f649b6d2b174bc899f1f092684fd commit cd5a8e80f949f649b6d2b174bc899f1f092684fd Author: fuzzyray <fuzzyray@gentoo.org> AuthorDate: 2009-05-07 22:15:50 +0000 Commit: fuzzyray <fuzzyray@gentoo.org> CommitDate: 2009-05-07 22:15:50 +0000 Add patch from Robert Buchholz: Add quiet option Incorporate option to quiet down glsa-check, based on a patch by Thilo Bangert <bangert@gentoo.org> in bug #170784. This option will also suppress sending of empty mail, based on a patch by Christian Gut <cycloon@is-root.org> in bug #182990. svn path=/trunk/gentoolkit/; revision=633 Bug: https://bugs.gentoo.org/692872 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* man/glsa-check.1: update the glsa-check man pageAaron Bauman2019-08-261-62/+57
| | | | | | | | | | | | | * Remove "Gentoo" from the name. It is obvious. * Change "SYNTAX" to "SYNOPSIS" which is more common among man pages * Update description to use the command name vice "This tool" * Move bug reporting information to BUGS section * Remove references to the "portage tree". Just call it a repo. * Add the "sets" all, new, and affected to the SYNOPSIS * Sentence case and add periods to all option descriptions Signed-off-by: Aaron Bauman <bman@gentoo.org> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* glsa-check: install in /usr/bin (bug 463952)Zac Medico2019-08-181-0/+66
| | | | | | | | In order to eliminate the duplicate implementation from gentoolkit, install glsa-check into /usr/bin and add man page from gentoolkit. Bug: https://bugs.gentoo.org/463952 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* man/ebuild.5: Document PROPERTIES="live".Ulrich Müller2019-07-271-2/+6
| | | | Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* man/ebuild.5: Fix .nf macro usage.Ulrich Müller2019-07-271-2/+4
| | | | | | | | Several .nf (no-fill mode) blocks were not terminated by .fi, causing broken formatting of the rest of the manpage. Fixes: cdcf4a28409daa7c56a0c2c94054f48bd5e43c6d Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* repos.conf: default sync-webrsync-verify-signatureZac Medico2019-07-101-2/+4
| | | | | | | | | | | | | | | | | | Enable sync-webrsync-verify-signature by default in repos.conf (due to dependencies the ebuild will make this conditional on USE=rsync-verify in the same way as the default sync-rsync-verify-metamanifest value). Use a new PORTAGE_TEMP_GPG_DIR variable to distinguish indirect emerge-webrsync calls that use gemato for secure key refresh, and disable direct emerge-webrsync calls. Deprecate FEATURES=webrsync-gpg and use it to trigger a backward-compatibility mode where direct emerge-webrsync calls are allowed (but trigger a warning message). Since direct emerge-webrsync calls do not use gemato for secure key refresh, this behavior will not be supported in a future release. Bug: https://bugs.gentoo.org/689506 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Improvements for man 5 ebuild to reflect EAPI 7 changes.Daniel Robbins2019-07-101-2/+22
| | | | | Closes: https://github.com/gentoo/portage/pull/437 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* man/emerge.1: --update implies --selectiveZac Medico2019-06-191-1/+2
| | | | | | Reported-by: Ben Kohler <bkohler@gentoo.org> Bug: https://bugs.gentoo.org/688356#c2 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Update default RPMDIR to /var/cache/rpm.Ulrich Müller2019-06-091-2/+2
| | | | | | | | | | After the other locations have been updated, RPMDIR is the only directory with a default under /usr/portage. Update its default along the lines of PKGDIR. Bug: https://bugs.gentoo.org/687734 Signed-off-by: Ulrich Müller <ulm@gentoo.org> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Enable FEATURES=strict-keepdir behavior for new EAPIsZac Medico2019-04-291-0/+1
| | | | | | Suggested-by: Pacho Ramos <pacho@gentoo.org> Bug: https://bugs.gentoo.org/651678 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Update /usr/portage references (bug 378603)Zac Medico2019-04-185-42/+37
| | | | | | | | | | Update all relevant references in docs, messages, and comments to refer to /var/db/repos/gentoo instead of /usr/portage. Also update DISTDIR and PKGDIR references to refer to the new /var/cache/{distfiles,binpkgs} locations. Bug: https://bugs.gentoo.org/378603 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* repos.conf: add sync-openpgp-keyserver option (bug 680908)Matthew Thode2019-03-311-0/+5
| | | | | | | | | | Allowing users to define which keyservers they update from allows them to work around buggy keyservers. It is also useful for local mirrors and / or private keyservers. Bug: https://bugs.gentoo.org/680908 Signed-off-by: Matthew Thode <mthode@mthode.org> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* man: Remove obsolete cross-compilation sectionJames Le Cuirot2019-03-171-43/+0
| | | | | | | | | | | | | | | It makes heavy use of ambiguous terminology from EAPI 5-hdepend. Part of it talks about the targetroot USE flag, which we do not plan to formally adopt into PMS. Overall, it is more likely to confuse than help people. I thought about rewriting it but it is difficult to summarise this complex subject in a useful way. The wiki is probably a better place to write about it. Closes: https://github.com/gentoo/portage/pull/413 Signed-off-by: James Le Cuirot <chewi@gentoo.org> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* man: Replace HDEPEND description with newer BDEPEND descriptionJames Le Cuirot2019-03-171-11/+12
| | | | | | | Include a passing reference to HDEPEND from EAPI 5-hdepend. Signed-off-by: James Le Cuirot <chewi@gentoo.org> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* man: Update has_version and best_version descriptions for EAPI 7James Le Cuirot2019-03-171-14/+22
| | | | | | Closes: https://github.com/gentoo/portage/pull/412 Signed-off-by: James Le Cuirot <chewi@gentoo.org> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Don't define a default for ACCEPT_LICENSEUlrich Müller2019-02-121-3/+3
| | | | | | | | | | | | | | | | | In its 2019-02-10 meeting, the Gentoo Council has decided that the default for ACCEPT_LICENSE should be changed to @FREE. We take that opportunity to move the default to make.defaults in the base profile, for the following reasons: - The setting depends on the @FREE license group, which itself is not defined in Portage, but in profiles/license_groups. - Setting the default in profiles will allow to perform the switchover at a precise time, independent of Portage release and stabilisation schedule. - Profiles are a better location to define the default distro policy. - GLEP 23 says so. Bug: https://bugs.gentoo.org/677800 Signed-off-by: Ulrich Müller <ulm@gentoo.org>
* man: fix random bad double spacesMike Frysinger2018-12-202-4/+4
| | | | Signed-off-by: Mike Frysinger <vapier@gentoo.org>
* Update documentation for PORT_LOGDIR* changesM. J. Everitt2018-12-191-11/+17
| | | | | | Suggested-by: Michael Everitt <m.j.everitt@iee.org> Bug: https://bugs.gentoo.org/668538 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Renamed PORT_LOGDIR[_CLEAN] to PORTAGE_LOGDIR[_CLEAN]M. J. Everitt2018-12-194-14/+14
| | | | | | | | | To match similar existing PORTAGE_* variables Suggested-by: Zac Medico <zmedico@gentoo.org> Acked-by: Michael Everitt <m.j.everitt@iee.org> Bug: https://bugs.gentoo.org/668538 Signed-off-by: Zac Medico <zmedico@gentoo.org>
* Support FEATURES=pid-sandboxMichał Górny2018-11-181-0/+7
| | | | | | | | | | Supporting using PID namespace in order to isolate the ebuild processes from host system, and make it possible to kill them all easily (similarly to cgroups but easier to use). Bug: https://bugs.gentoo.org/659582 Reviewed-by: Zac Medico <zmedico@gentoo.org> Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Add FEATURES=mount-sandbox to take advantage of mount nsMichał Górny2018-11-181-0/+5
| | | | | | | | Support FEATURES=mount-sandbox that unshares the ebuild processes into a new mount namespace and makes all the mounts private by default. Reviewed-by: Zac Medico <zmedico@gentoo.org> Signed-off-by: Michał Górny <mgorny@gentoo.org>
* Support disabling stripping for binary packagesMichał Górny2018-11-051-3/+12
| | | | | | | | | | | | | | | Similarly to FEATURES=binpkg-docompress, implement FEATURES=binpkg-dostrip that controls whether stripping occurs before or after building the binary package. This makes it possible to build binary packages with some debug information that is stripped upon installing. Afterwards, the binary packages can be reinstalled with debug info (either via nostrip or splitdebug). Real usability of this feature will be limited by optimization levels applied but still, it's better than nothing. Signed-off-by: Michał Górny <mgorny@gentoo.org> Reviewed-by: Zac Medico <zmedico@gentoo.org>
* Support disabling docompress for binary package buildsMichał Górny2018-11-052-0/+11
| | | | | | | | | | | | | | | | | | | | | | | | | | | Add FEATURES=binpkg-docompress that can be used whether docompress compression is performed before or after creating binary packages. With the feature enabled (the default), the current behavior of storing compressed files in binpkg is preserved. With it disabled, uncompressed files are stored inside binary package and are compressed when installing. Storing uncompressed files in binary packages has two advantages: 1. Avoids the double-compression penalty, effectively improving binary package compression speed and compression ratio. 2. Allows the same packages to be reused on systems with different docompress configurations. The option is roughly backwards compatible. Old Portage versions will install packages created with FEATURES=-binpkg-docompress correctly, albeit without compression. Portage with FEATURES=binpkg-docompress should install old binpackages semi-correctly, potentially recompressing them (and throwing already-compressed warnings on format mismatch). The new behavior is left off by default to avoid those problems. Signed-off-by: Michał Górny <mgorny@gentoo.org> Reviewed-by: Zac Medico <zmedico@gentoo.org>
* man: ebuild: clarify revision handling in PVR/PFMike Frysinger2018-10-021-1/+5
| | | | Signed-off-by: Mike Frysinger <vapier@gentoo.org>
* Add sync-rcu support for rsync (bug 662070)Zac Medico2018-09-231-0/+35
| | | | | | | | | | | | | | | | | | | | | | | | Add a boolean sync-rcu repos.conf setting that behaves as follows: Enable read-copy-update (RCU) behavior for sync operations. The current latest immutable version of a repository will be referenced by a symlink found where the repository would normally be located (see the location setting). Repository consumers should resolve the cannonical path of this symlink before attempt to access the repository, and all operations should be read-only, since the repository is considered immutable. Updates occur by atomic replacement of the symlink, which causes new consumers to use the new immutable version, while any earlier consumers continue to use the cannonical path that was resolved earlier. This option requires sync-allow-hardlinks and sync-rcu-store-dir options to be enabled, and currently also requires that sync-type is set to rsync. This option is disabled by default, since the symlink usage would require special handling for scenarios involving bind mounts and chroots. Bug: https://bugs.gentoo.org/662070 Reviewed-by: Brian Dolbec <dolsen@gentoo.org> Signed-off-by: Zac Medico <zmedico@gentoo.org>
* man/emerge.1: fix "the the" typo (bug 664272)Zac Medico2018-08-291-1/+1
| | | | | Reported-by: kmac <korey@koreymacdougall.com> Bug: https://bugs.gentoo.org/664272
* Refer to "ebuild repository" rather than "portage tree"Zac Medico2018-08-063-9/+9
|
* Replace implicit {FEATURES->USE}=test forcing with USE defaultMichał Górny2018-07-311-1/+5
| | | | | | | | | | | | | | | Use an explicit USE_ORDER entry to control mapping FEATURES=test into default-enabled USE=test, rather than forcing/masking it depending on the state of FEATURES. This makes it possible for users to enable (or disable) USE=test independently of FEATURES. An example use case is installing test dependencies and building test cases without actually running tests at a particular moment which is something I've been doing quite frequently with LLVM. Reviewed-by: Zac Medico <zmedico@gentoo.org> Closes: https://github.com/gentoo/portage/pull/347