aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMike Frysinger <vapier@gentoo.org>2016-06-19 23:10:38 -0400
committerMike Frysinger <vapier@gentoo.org>2016-06-19 23:10:38 -0400
commit3040132ef330e83c1a04f05eda333c79ae4868a8 (patch)
treefd6bfda6fbd02030485fc2d092b258289ac79f3d /man/qfile.1
parentman: drop qfile --from docs (diff)
downloadportage-utils-3040132ef330e83c1a04f05eda333c79ae4868a8.tar.gz
portage-utils-3040132ef330e83c1a04f05eda333c79ae4868a8.tar.bz2
portage-utils-3040132ef330e83c1a04f05eda333c79ae4868a8.zip
man: drop qfile --from docs (part 2)
Have to regen the man page after updating its fragment.
Diffstat (limited to 'man/qfile.1')
-rw-r--r--man/qfile.163
1 files changed, 1 insertions, 62 deletions
diff --git a/man/qfile.1 b/man/qfile.1
index e57e8e3a..5bd58c77 100644
--- a/man/qfile.1
+++ b/man/qfile.1
@@ -1,4 +1,4 @@
-.TH qfile "1" "Mar 2016" "Gentoo Foundation" "qfile"
+.TH qfile "1" "Jun 2016" "Gentoo Foundation" "qfile"
.SH NAME
qfile \- list all pkgs owning files
.SH SYNOPSIS
@@ -148,67 +148,6 @@ Sure, the same differences hold when querying for orphan files:
$ ROOT=/mnt qfile -Ro /mnt/bin/*
/mnt/bin/dostuff.sh
.fi
-.SH "READING ARGUMENTS FROM A FILE/STDIN"
-.PP
-When you try to launch \fBqfile\fP with a large number of arguments, you may
-hit the following shell error:
-.nf\fI
- $ qfile -o $(find /usr/lib)
- bash: ./qfile: Argument list too long
-.fi
-.PP
-To avoid that, you must use the \fB\-\-from\fP (\fB\-f\fP) option, which
-allows reading your arguments list in a file:
-.nf\fI
- $ find /usr/lib > ~/usr-lib.list
- $ qfile -o -f ~/usr-lib.list
- /usr/lib/libMagick-5.5.7-Q16.so.0.0.0
- /usr/lib/libGL.so
- ...
-.fi
-.PP
-Your arguments list must be formatted with one file per line, and without any
-kind of garbage (no leading or trailing space, no empty line, etc.). The
-default \fBfind\fP output format is just fine in general.
-.PP
-You can also read the arguments list from standard input with the "\fB\-\fP"
-pseudo filename, which is useful with shell pipes:
-.nf\fI
- $ find /usr/lib | qfile -o -f -
- /usr/lib/libMagick-5.5.7-Q16.so.0.0.0
- /usr/lib/libGL.so
- ...
-.fi
-.PP
-Here is an other example of use. This script lists some files which may be
-orphan config files left behind by Portage after uninstallation or upgrade of
-some packages:
-.nf\fI
- #!/bin/bash
- SEARCH_PATHS="$(portageq envvar CONFIG_PROTECT)"
- SEARCH_MASK="$(portageq envvar CONFIG_PROTECT_MASK) \\
- /etc/runlevels /etc/portage \\
- /etc/ssl/certs /etc/ssh \\
- /etc/bash_completion.d /etc/cups"
- for path in ${SEARCH_MASK} ; do
- EXCLUDE="${EXCLUDE} -not -path ${path}/*"
- done
- set -f
- find ${SEARCH_PATHS} ${EXCLUDE} | qfile -o -f -
-.fi
-.PP
-\fBIMPORTANT:\fP this script is just a quick example. Do not blindly delete the
-files it will list!
-.PP
-When reading arguments from a file or from stdin, \fBqfile\fP will, for
-performances reasons, treat then by groups of 5000 (search owners of the
-5000 first files, then of the 5000 following ones, etc.). This magic value
-should be fine in most cases, but you can change it if you really want, using
-the \fB\-\-max\-args\fP option (\fB\-m\fP). Using a greater value will eat a
-bit more memory, but may be a bit faster for really big queries. Be careful
-though, using some stupidly high or low value can completly kill the
-performances. In short, you probably don't want to touch this option.
-.PP
.SH "SEARCHING FOR FILE COLLISIONS"
.PP
A last option of \fBqfile\fP is \fB\-\-exclude\fP (\fB\-x\fP), which will makes