File: device_xml.3

package info (click to toggle)
discover 2.1.2-7
  • links: PTS
  • area: main
  • in suites: jessie, jessie-kfreebsd
  • size: 6,244 kB
  • ctags: 2,776
  • sloc: sh: 8,115; ansic: 7,275; xml: 1,809; makefile: 726
file content (144 lines) | stat: -rw-r--r-- 5,005 bytes parent folder | download | duplicates (9)
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
132
133
134
135
136
137
138
139
140
141
142
143
144
.TH "Device list XML parsing" 3 "28 Jul 2005" "discover" \" -*- nroff -*-
.ad l
.nh
.SH NAME
Device list XML parsing \- 
.SS "Functions"

.in +1c
.ti -1c
.RI "void \fBdiscover_xml_merge_device_url\fP (\fBdiscover_device_t\fP **dlist, char *url, \fBdiscover_xml_busclass_t\fP *busclasses, \fBdiscover_xml_vendor_t\fP *vendors, \fBdiscover_error_t\fP *status)"
.br
.ti -1c
.RI "\fBdiscover_device_t\fP * \fBdiscover_xml_get_devices\fP (\fBdiscover_bus_t\fP bus, \fBdiscover_error_t\fP *status)"
.br
.ti -1c
.RI "void \fBdiscover_xml_free_devices\fP (void)"
.br
.ti -1c
.RI "\fBdiscover_device_t\fP * \fBdiscover_xml_find_device\fP (\fBdiscover_device_t\fP *xml_devices, char *target_vendor, char *target_model, \fBdiscover_error_t\fP *status)"
.br
.ti -1c
.RI "\fBdiscover_device_t\fP * \fBdiscover_xml_find_next_device\fP (\fBdiscover_device_t\fP *xml_devices, char *target_vendor, char *target_model, \fBdiscover_error_t\fP *status)"
.br
.ti -1c
.RI "\fBdiscover_device_t\fP * \fBdiscover_xml_get_matching_devices\fP (\fBdiscover_device_t\fP *xml_devices, char *target_vendor, char *target_model, \fBdiscover_error_t\fP *status)"
.br
.in -1c
.SH "Function Documentation"
.PP 
.SS "\fBdiscover_device_t\fP* discover_xml_find_device (\fBdiscover_device_t\fP * xml_devices, char * target_vendor, char * target_model, \fBdiscover_error_t\fP * status)"
.PP
Find the first device in xml_devices matching target_vendor and/or target_model. (One or both can be specified, but not zero.)
.PP
\fBParameters:\fP
.RS 4
\fIxml_devices\fP List of devices to search 
.br
\fItarget_vendor\fP Vendor for which to search 
.br
\fItarget_model\fP Model for which to search 
.br
\fIstatus\fP Address in which to place status report 
.RE
.PP

.PP
Definition at line 550 of file device-xml.c.
.PP
Referenced by discover_xml_find_next_device(), and discover_xml_get_matching_devices().
.SS "\fBdiscover_device_t\fP* discover_xml_find_next_device (\fBdiscover_device_t\fP * xml_devices, char * target_vendor, char * target_model, \fBdiscover_error_t\fP * status)"
.PP
Find the next device in xml_devices matching target_vendor and/or target_model. (One or both can be specified, but not zero.)
.PP
The first device in the list is assumed to have been processed, so we simply call \fBdiscover_xml_find_device()\fP on the next pointer.
.PP
\fBParameters:\fP
.RS 4
\fIxml_devices\fP List of devices to search 
.br
\fItarget_vendor\fP Vendor for which to search 
.br
\fItarget_model\fP Model for which to search 
.br
\fIstatus\fP Address in which to place status report 
.RE
.PP

.PP
Definition at line 594 of file device-xml.c.
.PP
References discover_xml_find_device().
.PP
Referenced by discover_xml_get_matching_devices().
.SS "void discover_xml_free_devices (void)"
.PP
Free the list of XML devices. 
.PP
Definition at line 531 of file device-xml.c.
.PP
References BUS_COUNT, and discover_device_free().
.SS "\fBdiscover_device_t\fP* discover_xml_get_devices (\fBdiscover_bus_t\fP bus, \fBdiscover_error_t\fP * status)"
.PP
Get the list of devices for the required bus.
.PP
\fBParameters:\fP
.RS 4
\fIbus\fP Bus for which the devices are requested 
.br
\fIstatus\fP Address in which to place status report 
.RE
.PP

.PP
Definition at line 484 of file device-xml.c.
.PP
References discover_error::code, discover_xml_get_busclasses(), discover_xml_get_data_urls(), discover_xml_get_vendors(), discover_xml_merge_device_url(), discover_xml_url_get_next(), and discover_xml_url_get_url().
.PP
Referenced by discover_get_devices().
.SS "\fBdiscover_device_t\fP* discover_xml_get_matching_devices (\fBdiscover_device_t\fP * xml_devices, char * target_vendor, char * target_model, \fBdiscover_error_t\fP * status)"
.PP
Find and duplicate all devices in xml_devices matching target_vendor and/or target_model. (One or both can be specified, but not zero.)
.PP
\fBParameters:\fP
.RS 4
\fIxml_devices\fP List of devices to search 
.br
\fItarget_vendor\fP Vendor for which to search 
.br
\fItarget_model\fP Model for which to search 
.br
\fIstatus\fP Address in which to place status report 
.RE
.PP

.PP
Definition at line 614 of file device-xml.c.
.PP
References discover_device_copy(), discover_device_new(), discover_xml_find_device(), and discover_xml_find_next_device().
.PP
Referenced by discover_get_devices().
.SS "void discover_xml_merge_device_url (\fBdiscover_device_t\fP ** dlist, char * url, \fBdiscover_xml_busclass_t\fP * busclasses, \fBdiscover_xml_vendor_t\fP * vendors, \fBdiscover_error_t\fP * status)"
.PP
Merge new busclasses into a list.
.PP
\fBParameters:\fP
.RS 4
\fIdlist\fP Address of the list to merge busclasses into 
.br
\fIurl\fP URL of the document defining the busclasses 
.br
\fIbusclasses\fP List of busclasses for this bus 
.br
\fIvendors\fP List of vendors for this bus 
.br
\fIstatus\fP Address in which to place status report 
.RE
.PP

.PP
Definition at line 425 of file device-xml.c.
.PP
References discover_error::code, DISCOVER_EIO, and DISCOVER_EXML.
.PP
Referenced by discover_xml_get_devices().