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
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
|
# File '../../src/include/scanner/helps.rb', line 29
def initialize_scanner_helps(include_target)
textdomain "scanner"
@HELPS = {
"read" =>
_(
"<p>\n" +
"<b><big>Initializing Scanner Configuration</big></b><br>\n" +
"Please wait...\n" +
"</p>"
),
"write" =>
_(
"<p>\n" +
"<b><big>Saving Scanner Configuration</big></b><br>\n" +
"Please wait...\n" +
"</p>"
),
"overview" =>
_(
"<p>\n" +
"<b><big>Scanner Configuration</big></b><br>\n" +
"Set up or change the scanner configuration and show the already active scanners.\n" +
"</p>"
) +
_(
"<p>\n" +
"To set up a new scanner, choose the scanner from the list of\n" +
"detected scanners and press <b>Edit</b>.\n" +
"If your scanner has not been detected, use <b>Add</b> for a manual configuration.\n" +
"</p>"
) +
_(
"<p>\n" +
"A normal USB scanner should be detected automatically.\n" +
"By default, only those USB scanners are shown\n" +
"for which the USB vendor and product IDs are known.\n" +
"If a USB scanner is not shown or if there are unexpected results,\n" +
"try <b>Other</b> and <b>Restart Detection</b>.\n" +
"It might happen that particular USB devices which are not scanners\n" +
"are shown too. There is no generic way to reliably distinguish a scanner\n" +
"from other USB devices because there is no USB device class for scanners.\n" +
"Try to proceed with <b>Add</b>.\n" +
"For HP all-in-one devices you may have to run <tt>hp-setup</tt>\n" +
"via <b>Other</b> and <b>Run hp-setup</b> before you can \n" +
"configure the scanner unit with this tool.\n" +
"If you have difficulties configuring your scanner,\n" +
"check whether it appears in the output of <tt>lsusb</tt>.\n" +
"If it is not listed there, the USB system cannot communicate with the scanner.\n" +
"</p>\n"
) +
_(
"<p>\n" +
"SCSI scanners are normally detected.\n" +
"If difficulties arise proceeding with <b>Add</b>,\n" +
"check whether your scanner is shown by the command <tt>lsscsi</tt>.\n" +
"If not, the SCSI system cannot communicate with the scanner.\n" +
"Verify that an appropriate kernel module for the SCSI host adapter has been loaded.\n" +
"</p>"
) +
_(
"<p>\n" +
"Parallel port scanners cannot be configured with this tool\n" +
"except for HP all-in-one devices.\n" +
"Common parallel port scanners must be configured manually.\n" +
"To set up the scanner unit in a HP all-in-one device,\n" +
"which is connected to the parallel port,\n" +
"you may have to run <tt>hp-setup</tt> via <b>Other</b> and <b>Run hp-setup</b>\n" +
"before you can configure the scanner unit with this tool using <b>Add</b>.\n" +
"</p>\n"
) +
_(
"<p>\n" +
"Network scanners cannot be configured with this tool\n" +
"except for HP all-in-one devices.\n" +
"Network scanners must be configured manually.\n" +
"A network scanner is a scanner that has a network interface\n" +
"so it is directly accessible in the network.\n" +
"In contrast, scanning via network means accessing a remote scanner\n" +
"connected to another host in the network.\n" +
"To set up the scanner unit in a HP all-in-one device,\n" +
"which is connected via a built-in network interface,\n" +
"you may have to run <tt>hp-setup</tt> via <b>Other</b> and <b>Run hp-setup</b>\n" +
"before it works to configure the scanner unit with this tool using <b>Add</b>.\n" +
"</p>\n"
) +
_(
"<p>\n" +
"The table lists the configured drivers with their associated scanners.\n" +
"Press <b>Add</b> to select model and driver and enable it.\n" +
"Press <b>Edit</b> to select and enable a driver.\n" +
"Press <b>Delete</b> to disable the driver.\n" +
"If you press <b>Other</b>, you can restart the detection, test enabled drivers,\n" +
"set up HP all-in-one devices, or set up scanning via network.\n" +
"</p>"
) +
_(
"<p>\n" +
"If a driver is set up but no scanner is recognized by the driver, possible reasons are:\n" +
"The scanner is not connected or switched off,\n" +
"the driver is not the right one for the particular model\n" +
"(even small differences in model names or internal differences in\n" +
"the same model series may require different drivers),\n" +
"there are low-level (kernel related) device communication problems\n" +
"(e.g. a low-level USB problem or a low-level SCSI problem).\n" +
"</p>"
),
"select_model" =>
_(
"<p>\n" +
"<b><big>Scanner Model Selection</big></b><br>\n" +
"All known scanner models, both supported and unsupported, are listed here.\n" +
"Read all information carefully before selecting a model and pressing <b>Next</b>.\n" +
"The information is based on data of the SANE project at\n" +
"<tt>http://www.sane-project.org/</tt>.\n" +
"</p>"
) +
_(
"<p>\n" +
"A model is supported if there is at least one appropriate scanner driver available.\n" +
"Most scanner drivers are from the SANE project and provided in the sane-backends package.\n" +
"The support status for a particular model varies from minimal to complete.<br>\n" +
"When a driver is shown as 'unmaintained', it does not mean that the driver does not work.\n" +
"Even an unmaintained driver could work perfectly well.\n" +
"But it means that there is no longer someone who knows about the driver internals\n" +
"so that there is usually no help if there are issues with an unmaintained driver.\n" +
"</p>"
) +
_(
"<p>\n" +
"Even if a model has no driver available, the manufacturer might have a driver.\n" +
"Therefore, you should ask the scanner manufacturer for a driver for an unsupported scanner.\n" +
"</p>"
) +
_(
"<p>\n" +
"When additional comments are available, they are shown in square brackets.\n" +
"</p>"
) +
_(
"<p>\n" +
"Use the <b>Search String</b> to find an appropriate entry quickly.\n" +
"To find some text anywhere in the table, enter it in the field.\n" +
"A more complicated search using a case-insensitive regular expression is also possible.\n" +
"If the scanner was detected and the manufacturer name is available in this list,\n" +
"the search string is preset with the manufacturer name, such as <tt>^Epson.*</tt>.\n" +
"To refine the search results, append model-specific details to the search string.\n" +
"For example, append a word that is part of the model name as in <tt>^Epson.*perfection</tt>\n" +
"or append some digits that are part of the model name as in <tt>^Epson.*1200</tt>.\n" +
"</p>"
),
"configure_backend" =>
_(
"<p>\n" +
"<b><big>Scanner and Driver Setup</big></b><br>\n" +
"The driver is activated and the associated scanners are probed.\n" +
"This may take a few seconds, so you must wait until you can press <b>Next</b>.\n" +
"If you press <b>Back</b>, the driver is deactivated.\n" +
"</p>"
) +
_(
"<p>\n" +
"<b><big>Additional Packages</big></b><br>\n" +
"If the package that provides the driver is not yet installed,\n" +
"an appropriate dialog is shown to install the package.\n" +
"Such packages may not be available for all architectures.\n" +
"</p>"
) +
_(
"<p>\n" +
"<b><big>Firmware Upload</big></b><br>\n" +
"Some models require a firmware upload.\n" +
"In this case, an appropriate explanatory text is shown.\n" +
"</p>"
) +
_(
"<p>\n" +
"<b><big>HP All-in-One Devices</big></b><br>\n" +
"HP all-in-one devices may require a special setup.\n" +
"In this case, an appropriate dialog is shown.\n" +
"There are two software packages that provide support for HP all-in-one devices:\n" +
"the outdated HPOJ software (package hp-officeJet which is no longer available),\n" +
"which provides the PTAL system (with the ptal service) to access HP all-in-one devices,\n" +
"and the up-to-date HPLIP software (package hplip), which provides the hpaio driver.\n" +
"Both software packages can be installed at the same time\n" +
"but the ptal service and the hpaio driver cannot run together.\n" +
"Therefore either the patl service or the hpaio driver\n" +
"must be used for all HP all-in-one devices.\n" +
"</p>"
),
"configure_network_scanning" =>
_(
"<p>\n" +
"<b><big>Scanning via Network</big></b><br>\n" +
"Enter the appropriate information and press <b>Next</b>\n" +
"to set up scanning via network.\n" +
"</p>"
) +
_(
"<p>\n" +
"<b><big>Server Settings</big></b><br>\n" +
"If you have locally connected scanners and want to make them accessible via the network,\n" +
"set up the saned network scanning daemon so that your host becomes a server.\n" +
"In <b>Permitted Clients</b>, enter which client hosts are permitted to access saned on your server.\n" +
"Enter a comma-separated list of client hosts (hostnames or IP addresses)\n" +
"or subnets (CIDR notation, such as 192.168.1.0/24).\n" +
"If no client hosts are permitted, saned is not activated.\n" +
"If saned is activated, xinetd is also activated and set up for saned.\n" +
"</p>"
) +
_(
"<p>\n" +
"<b><big>Regarding Firewall</big></b><br>\n" +
"A firewall is used to protect running server processes\n" +
"on your host against unwanted access via network.\n" +
"For using scanners via network the SANE network daemon (the saned)\n" +
"is the server process which must run so that remote clients\n" +
"can access scanners which are connected to your local host.\n" +
"Client hosts contact the saned via the sane-port (TCP port 6566)\n" +
"but scanning data is transferred via an additional random port.\n" +
"Therefore only port 6566 is not sufficient for scanning via network.<br>\n" +
"Do not open the sane-port 6566 or any other port\n" +
"regarding using scanners for the external zone in the firewall.\n" +
"This is dangerous because it allows access to the saned from foreign hosts\n" +
"so that the firewall does no longer provide any protection for the saned.\n" +
"Allowing access from the external network (i.e. for the external zone)\n" +
"does not make sense because scanning documents requires\n" +
"physical scanner access by trusted users.<br>\n" +
"On the other hand the default firewall settings allow\n" +
"any access from an internal (i.e. trusted) network.\n" +
"To make the saned on your server accessible from an internal network,\n" +
"assign the network interface which belongs to the internal network\n" +
"to the internal zone of the firewall.\n" +
"Use the YaST Firewall setup module to do this fundamental setup\n" +
"regarding network security and firewall and scanning via network\n" +
"will work without any further firewall setup.<br>\n" +
"For details see the openSUSE support database\n" +
"article 'CUPS and SANE Firewall settings' at<br>\n" +
"http://en.opensuse.org/SDB:CUPS_and_SANE_Firewall_settings\n" +
"</p>"
) +
_(
"<p>\n" +
"<b><big>Client Settings</big></b><br>\n" +
"If you want to access scanners connected to other hosts (servers) in the network,\n" +
"set up the net metadriver to access them via the daemon running on the servers.\n" +
"The saned and the firewall on the servers must permit the access.\n" +
"In <b>Servers Used</b>, enter which servers should be used.\n" +
"Enter a comma-separated list of servers (server names or IP addresses).\n" +
"If no servers are entered, net is not activated.\n" +
"</p>"
) +
_(
"<p>\n" +
"<b><big>Local Host Configuration</big></b><br>\n" +
"By using the loopback network, saned and the net metadriver\n" +
"can be used even on your local host.\n" +
"In this case, the server and client are the same machine (localhost).\n" +
"Some scanners, such as parallel port scanners, require root privileges.\n" +
"When you enter <tt>localhost</tt> for both the server and the client,\n" +
"you can access such a scanner even as a normal user on your local host.\n" +
"</p>"
)
}
end
|