commit: 3fb265e0863689e3e352fc6abcedc77a262323f2 Author: Mike Frysinger <vapier <AT> gentoo <DOT> org> AuthorDate: Wed Jun 15 04:55:06 2016 +0000 Commit: Mike Frysinger <vapier <AT> gentoo <DOT> org> CommitDate: Wed Jun 15 04:55:06 2016 +0000 URL: https://gitweb.gentoo.org/proj/portage-utils.git/commit/?id=3fb265e0
man: drop qfile --from docs URL: https://bugs.gentoo.org/573574 Reported-by: Rick Farina <zerochaos <AT> gentoo.org> man/include/qfile-04-from.include | 61 --------------------------------------- 1 file changed, 61 deletions(-) diff --git a/man/include/qfile-04-from.include b/man/include/qfile-04-from.include deleted file mode 100644 index 47652bb..0000000 --- a/man/include/qfile-04-from.include +++ /dev/null @@ -1,61 +0,0 @@ -.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