diff options
author | Mike Frysinger <vapier@gentoo.org> | 2016-06-19 23:10:38 -0400 |
---|---|---|
committer | Mike Frysinger <vapier@gentoo.org> | 2016-06-19 23:10:38 -0400 |
commit | 3040132ef330e83c1a04f05eda333c79ae4868a8 (patch) | |
tree | fd6bfda6fbd02030485fc2d092b258289ac79f3d /man/qfile.1 | |
parent | man: drop qfile --from docs (diff) | |
download | portage-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.1 | 63 |
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 |