forked from freebsd/pkg
/
pkg-search.1
131 lines (131 loc) · 2.89 KB
/
pkg-search.1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
.\"
.\" FreeBSD pkg - a next generation package for the installation and maintenance
.\" of non-core utilities.
.\"
.\" 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.
.\"
.\"
.\" @(#)pkg.1
.\" $FreeBSD$
.\"
.Dd Aug 23, 2011
.Dt PKG-SEARCH 1
.Os
.Sh NAME
.Nm "pkg search"
.Nd searches in remote package repositories
.Sh SYNOPSIS
.Nm
.Ar pkg-name
.Nm
.Op Fl fDsqop
.Ar pkg-name
.Nm
.Op Fl gxXcdfDsqop
.Ar pattern
.Sh DESCRIPTION
.Nm
is used for searching in the remote package repositories
and displays the requested information for the matching
packages.
.Pp
.Nm
will search for the given pattern in the remote package
repositories, which are defined in the
.Fa /etc/pkg/repositories
file.
.Sh OPTIONS
The following options are supported by
.Nm :
.Bl -tag -width F1
.It Fl g
Treat
.Ar pattern
as a shell glob pattern.
.It Fl x
Treat
.Ar pattern
as a regular expression.
.It Fl X
Treat
.Ar pattern
as an extended regular expression.
.It Fl c
Search for
.Ar pattern
in the package comment one-line description.
.It Fl d
Search for
.Ar pattern
in the package desription.
.It Fl f
Displays full information about the matching packages.
.It Fl D
Displays the dependencies of
.Ar pattern
.It Fl s
Displays the size of the package
.It Fl q
Be ``quiet''. Prints only the requested information without
displaying many hints.
.It Fl o
Displays
.Ar pattern
origin.
.It Fl p
Displays the installation prefix for each package matching
.Ar pattern
.El
.Sh WARNING
.Sh ENVIRONMENT
The following environment variables affect the execution of
.Nm :
.Bl -tag -width ".Ev PACKAGESITE"
.It Ev PACKAGESITE
When \fBPACKAGESITE\fP is defined
.Nm
will only use the remote repository to which it points. Otherwise
.Nm
will work on multiple repositories as listed in the
.Pa /etc/pkg/repositories
file.
.El
.Sh FILES
.Bl -tag -width -".Pa /etc/pkg/repositories"
.It Pa /etc/pkg/repositories
Global repositories file. This file contains a pair of
.Fa name = url
entries, each describing a remote repository, from which
.Nm
will search for the specified pattern. The file format of the file is
described in the
.Xr pkg-repositories 5
man page.
.El
.Sh FILES
.Sh SEE ALSO
.Xr pkg 1 ,
.Xr pkg-add 1 ,
.Xr pkg-autoremove 1 ,
.Xr pkg-create 1 ,
.Xr pkg-backup 1 ,
.Xr pkg-install 1 ,
.Xr pkg-delete 1 ,
.Xr pkg-info 1 ,
.Xr pkg-register 1 ,
.Xr pkg-repo 1 ,
.Xr pkg-update 1 ,
.Xr pkg-upgrade 1 ,
.Xr pkg-version 1 ,
.Xr pkg-which 1 ,
.Xr pkg.conf 5 ,
.Xr pkg-repositories 5
.Sh AUTHORS AND CONTRIBUTORS
.Sh BUGS