diff options
Diffstat (limited to '')
| -rw-r--r-- | misc-utils/look.1 | 116 | ||||
| -rw-r--r-- | misc-utils/look.1.adoc | 112 |
2 files changed, 228 insertions, 0 deletions
diff --git a/misc-utils/look.1 b/misc-utils/look.1 new file mode 100644 index 0000000..b45090d --- /dev/null +++ b/misc-utils/look.1 @@ -0,0 +1,116 @@ +'\" t +.\" Title: look +.\" Author: [see the "AUTHOR(S)" section] +.\" Generator: Asciidoctor 2.0.20 +.\" Date: 2023-10-23 +.\" Manual: User Commands +.\" Source: util-linux 2.39.3 +.\" Language: English +.\" +.TH "LOOK" "1" "2023-10-23" "util\-linux 2.39.3" "User Commands" +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.ss \n[.ss] 0 +.nh +.ad l +.de URL +\fI\\$2\fP <\\$1>\\$3 +.. +.als MTO URL +.if \n[.g] \{\ +. mso www.tmac +. am URL +. ad l +. . +. am MTO +. ad l +. . +. LINKSTYLE blue R < > +.\} +.SH "NAME" +look \- display lines beginning with a given string +.SH "SYNOPSIS" +.sp +\fBlook\fP [options] \fIstring\fP [\fIfile\fP] +.SH "DESCRIPTION" +.sp +The \fBlook\fP utility displays any lines in \fIfile\fP which contain \fIstring\fP as a prefix. As \fBlook\fP performs a binary search, the lines in \fIfile\fP must be sorted (where \fBsort\fP(1) was given the same options \fB\-d\fP and/or \fB\-f\fP that \fBlook\fP is invoked with). +.sp +If \fIfile\fP is not specified, the file \fI/usr/share/dict/words\fP is used, only alphanumeric characters are compared and the case of alphabetic characters is ignored. +.SH "OPTIONS" +.sp +\fB\-a\fP, \fB\-\-alternative\fP +.RS 4 +Use the alternative dictionary file. +.RE +.sp +\fB\-d\fP, \fB\-\-alphanum\fP +.RS 4 +Use normal dictionary character set and order, i.e., only blanks and alphanumeric characters are compared. This is on by default if no file is specified. +.sp +Note that blanks have been added to dictionary character set for compatibility with \fBsort \-d\fP command since version 2.28. +.RE +.sp +\fB\-f\fP, \fB\-\-ignore\-case\fP +.RS 4 +Ignore the case of alphabetic characters. This is on by default if no file is specified. +.RE +.sp +\fB\-t\fP, \fB\-\-terminate\fP \fIcharacter\fP +.RS 4 +Specify a string termination character, i.e., only the characters in \fIstring\fP up to and including the first occurrence of \fIcharacter\fP are compared. +.RE +.sp +\fB\-h\fP, \fB\-\-help\fP +.RS 4 +Display help text and exit. +.RE +.sp +\fB\-V\fP, \fB\-\-version\fP +.RS 4 +Print version and exit. +.RE +.sp +The \fBlook\fP utility exits 0 if one or more lines were found and displayed, 1 if no lines were found, and >1 if an error occurred. +.SH "ENVIRONMENT" +.sp +\fBWORDLIST\fP +.RS 4 +Path to a dictionary file. The environment variable has greater priority than the dictionary path defined in the \fBFILES\fP segment. +.RE +.SH "FILES" +.sp +\fI/usr/share/dict/words\fP +.RS 4 +the dictionary +.RE +.sp +\fI/usr/share/dict/web2\fP +.RS 4 +the alternative dictionary +.RE +.SH "HISTORY" +.sp +The \fBlook\fP utility appeared in Version 7 AT&T Unix. +.SH "EXAMPLES" +.sp +.if n .RS 4 +.nf +.fam C +sort \-d /etc/passwd \-o /tmp/look.dict +look \-t: root:foobar /tmp/look.dict +.fam +.fi +.if n .RE +.SH "SEE ALSO" +.sp +\fBgrep\fP(1), +\fBsort\fP(1) +.SH "REPORTING BUGS" +.sp +For bug reports, use the issue tracker at \c +.URL "https://github.com/util\-linux/util\-linux/issues" "" "." +.SH "AVAILABILITY" +.sp +The \fBlook\fP command is part of the util\-linux package which can be downloaded from \c +.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."
\ No newline at end of file diff --git a/misc-utils/look.1.adoc b/misc-utils/look.1.adoc new file mode 100644 index 0000000..35b8978 --- /dev/null +++ b/misc-utils/look.1.adoc @@ -0,0 +1,112 @@ +//po4a: entry man manual +//// +Copyright (c) 1990, 1993 + The Regents of the University of California. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions +are met: +1. Redistributions of source code must retain the above copyright + notice, this list of conditions and the following disclaimer. +2. Redistributions in binary form must reproduce the above copyright + notice, this list of conditions and the following disclaimer in the + documentation and/or other materials provided with the distribution. +3. All advertising materials mentioning features or use of this software + must display the following acknowledgement: + This product includes software developed by the University of + California, Berkeley and its contributors. +4. Neither the name of the University nor the names of its contributors + may be used to endorse or promote products derived from this software + without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND +ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE +FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +SUCH DAMAGE. + + @(#)look.1 8.1 (Berkeley) 6/14/93 +//// += look(1) +:doctype: manpage +:man manual: User Commands +:man source: util-linux {release-version} +:page-layout: base +:command: look + +== NAME + +look - display lines beginning with a given string + +== SYNOPSIS + +*look* [options] _string_ [_file_] + +== DESCRIPTION + +The *look* utility displays any lines in _file_ which contain _string_ as a prefix. As *look* performs a binary search, the lines in _file_ must be sorted (where *sort*(1) was given the same options *-d* and/or *-f* that *look* is invoked with). + +If _file_ is not specified, the file _/usr/share/dict/words_ is used, only alphanumeric characters are compared and the case of alphabetic characters is ignored. + +== OPTIONS + +*-a*, *--alternative*:: +Use the alternative dictionary file. + +*-d*, *--alphanum*:: +Use normal dictionary character set and order, i.e., only blanks and alphanumeric characters are compared. This is on by default if no file is specified. ++ +Note that blanks have been added to dictionary character set for compatibility with *sort -d* command since version 2.28. + +*-f*, *--ignore-case*:: +Ignore the case of alphabetic characters. This is on by default if no file is specified. + +*-t*, *--terminate* _character_:: +Specify a string termination character, i.e., only the characters in _string_ up to and including the first occurrence of _character_ are compared. + +include::man-common/help-version.adoc[] + +The *look* utility exits 0 if one or more lines were found and displayed, 1 if no lines were found, and >1 if an error occurred. + +== ENVIRONMENT + +*WORDLIST*:: +Path to a dictionary file. The environment variable has greater priority than the dictionary path defined in the *FILES* segment. + +== FILES + +_/usr/share/dict/words_:: +the dictionary + +_/usr/share/dict/web2_:: +the alternative dictionary + +== HISTORY + +The *look* utility appeared in Version 7 AT&T Unix. + +== EXAMPLES + +.... +sort -d /etc/passwd -o /tmp/look.dict +look -t: root:foobar /tmp/look.dict +.... + +== SEE ALSO + +*grep*(1), +*sort*(1) + +include::man-common/bugreports.adoc[] + +include::man-common/footer.adoc[] + +ifdef::translation[] +include::man-common/translation.adoc[] +endif::[] |