-
Notifications
You must be signed in to change notification settings - Fork 858
Expand file tree
/
Copy pathrpmdbsearch.xml
More file actions
130 lines (123 loc) · 3.44 KB
/
rpmdbsearch.xml
File metadata and controls
130 lines (123 loc) · 3.44 KB
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
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<refentry xml:id="function.rpmdbsearch" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>rpmdbsearch</refname>
<refpurpose>Search RPM packages</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>array</type><type>null</type></type><methodname>rpmdbsearch</methodname>
<methodparam><type>string</type><parameter>pattern</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>rpmtag</parameter><initializer>RPMTAG_NAME</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>rpmmire</parameter><initializer>-1</initializer></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>full</parameter><initializer>&false;</initializer></methodparam>
</methodsynopsis>
<simpara>
Search packages in the system RPM database.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>pattern</parameter></term>
<listitem>
<simpara>
Value to search for.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>rpmtag</parameter></term>
<listitem>
<simpara>
Search criterion, which is one of the
<constant>RPMTAG_<replaceable>*</replaceable></constant> constants.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>rpmmire</parameter></term>
<listitem>
<simpara>
Pattern type, which is one of the
<constant>RPMMIRE_<replaceable>*</replaceable></constant> constants.
When < 0 the criterion must equal the value, and database index is used if possible.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>full</parameter></term>
<listitem>
<simpara>
If &true; all information headers for the file are retrieved, else only a minimal set.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
An <type>array</type> of <type>array</type> of information, or &null; on error.
</simpara>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Searching for the package owning a file</title>
<programlisting role="php">
<![CDATA[
<?php
$info = rpmdbsearch("/usr/bin/php", RPMTAG_INSTFILENAMES);
print_r($info);
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Array
(
[0] => Array
(
[Name] => php-cli
[Version] => 7.4.4
[Release] => 1.fc32
[Summary] => Command-line interface for PHP
[Arch] => x86_64
)
)
]]>
</screen>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>rpmaddtag</function></member>
</simplelist>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->