This file is indexed.

/usr/share/doc/libcomedi-dev/html/g6679.html is in libcomedi-dev 0.8.1-5ubuntu6.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
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
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>    Glossary
  </TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="    Comedi
  "
HREF="index.html"><LINK
REL="PREVIOUS"
TITLE="comedi_get_softcal_converter"
HREF="r6633.html"></HEAD
><BODY
CLASS="GLOSSARY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>Comedi: The <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Control and Measurement Device Interface</I
></SPAN
>
handbook
  </TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="r6633.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
></TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
>&nbsp;</TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="GLOSSARY"
><H1
><A
NAME="COMEDILIB-GLOSSARY"
></A
>    Glossary
  </H1
><DL
><DT
><A
NAME="API"
></A
><B
>    Application Program Interface
    </B
></DT
> (API)<DD
><P
>The (documented) set of function calls supported by a particular
application, by which programmers can access the functionality
available in the application.
      </P
></DD
><DT
><A
NAME="BUFFER"
></A
><B
>buffer
    </B
></DT
><DD
><P
><ACRONYM
CLASS="ACRONYM"
>Comedi</ACRONYM
> uses permanently allocated kernel memory for streaming input
and output to store data that has been measured by a device, but has
not been read by an application.  These buffers can be resized by the
Comedilib function <CODE
CLASS="FUNCTION"
>comedi_buffer_XXX()</CODE
> or the
<CODE
CLASS="FUNCTION"
>comedi_config</CODE
>
utility.
      </P
></DD
><DT
><A
NAME="BUFFEROVERFLOW"
></A
><B
>buffer overflow
    </B
></DT
><DD
><P
>This is an error message that indicates that the driver ran out of
space in a <ACRONYM
CLASS="ACRONYM"
>Comedi</ACRONYM
> buffer to put samples.  It means that the application
is not copying data out of the buffer quickly enough.  Often, this
problem can be fixed by making the <ACRONYM
CLASS="ACRONYM"
>Comedi</ACRONYM
> buffer larger.  See
<CODE
CLASS="FUNCTION"
>comedi_buffer_XXX</CODE
> for more information.
      </P
></DD
><DT
><A
NAME="DIFFERENTIALIO"
></A
><B
>    Differential IO
    </B
></DT
><DD
><P
>...
      </P
></DD
><DT
><A
NAME="DMA"
></A
><B
>    Direct Memory Access
    </B
></DT
> (DMA)<DD
><P
>DMA is a method of transferring data between
a device and the main memory of a computer.  DMA operates differently
on ISA and PCI cards.  ISA DMA is handled by a controller on the
motherboard and is limited to transfers to/from the lowest 16 MB of
physical RAM and can only handle a single segment of memory at a time.
These limitations make it almost useless.  PCI ("bus mastering") DMA
is handled by a controller on the device, and can typically address
4 GB of RAM and handle many segments of memory simultaneously.  DMA
is usually not the only means to data transfer, and may or may not
be the optimal transfer mechanism for a particular situation.
      </P
></DD
><DT
><A
NAME="FIFO"
></A
><B
>    First In, First Out
    </B
></DT
> (FIFO)<DD
><P
>Most devices have a limited amount of on-board space to store samples
before they are transferred to the Comedi buffer.  This allows the CPU or
DMA controller to do other things, and then efficiently process a
large number of samples simultaneously.  It also increases the
maximum interrupt latency that the system can handle without
interruptions in data.
      </P
></DD
><DT
><A
NAME="COMEDICOMMAND"
></A
><B
><ACRONYM
CLASS="ACRONYM"
>Comedi</ACRONYM
> command
    </B
></DT
><DD
><P
><ACRONYM
CLASS="ACRONYM"
>Comedi</ACRONYM
> commands are the mechanism that applications configure
subdevices for streaming input and output.
      </P
></DD
><DT
><A
NAME="COMMAND"
></A
><B
>command
    </B
></DT
><DD
><P
><EM
>See: </EM
><A
HREF="g6679.html#COMEDICOMMAND"
><ACRONYM
CLASS="ACRONYM"
>Comedi</ACRONYM
> command
    </A
></P
></DD
><DT
><A
NAME="CONFIGOPTION"
></A
><B
>configuration option
    </B
></DT
><DD
><P
>      </P
></DD
><DT
><A
NAME="INSTRUCTION"
></A
><B
>instruction
    </B
></DT
><DD
><P
><ACRONYM
CLASS="ACRONYM"
>Comedi</ACRONYM
> instructions are the mechanism used by applications to do
immediate input from channels, output to channels, and configuration
of subdevices and channels.
      </P
></DD
><DT
><A
NAME="INSTRUCTIONLIST"
></A
><B
>instruction list
    </B
></DT
><DD
><P
>Instruction lists allow the application to perform multiple <ACRONYM
CLASS="ACRONYM"
>Comedi</ACRONYM
>
instructions in the same system call.
      </P
></DD
><DT
><A
NAME="OPTION"
></A
><B
>option
    </B
></DT
><DD
><P
>      </P
><P
><EM
>See Also: </EM
><A
HREF="g6679.html#OPTIONLIST"
>option list
    </A
>.</P
></DD
><DT
><A
NAME="OPTIONLIST"
></A
><B
>option list
    </B
></DT
><DD
><P
>Option lists are used with <CODE
CLASS="FUNCTION"
>comedi_config</CODE
> to
perform driver configuration.
      </P
><P
><EM
>See Also: </EM
><A
HREF="g6679.html#CONFIGOPTION"
>configuration option
    </A
><EM
>, </EM
><A
HREF="g6679.html#OPTION"
>option
    </A
>.</P
></DD
><DT
><A
NAME="OVERRUN"
></A
><B
>overrun
    </B
></DT
><DD
><P
>This is an error message that indicates that there was device-level
problem, typically with trigger pulses occurring faster than the
board can handle.
      </P
></DD
><DT
><A
NAME="POLL"
></A
><B
>poll
    </B
></DT
><DD
><P
>The term poll (and polling) is used for several different related
concepts in <ACRONYM
CLASS="ACRONYM"
>Comedi</ACRONYM
>.  <ACRONYM
CLASS="ACRONYM"
>Comedi</ACRONYM
> implements the
<CODE
CLASS="FUNCTION"
>poll()</CODE
> system call for Comedi devices, which is
similar to <CODE
CLASS="FUNCTION"
>select()</CODE
>, and returns information
about file descriptors that can be read or written.  Comedilib also
has a function called <CODE
CLASS="FUNCTION"
>comedi_poll()</CODE
>, which causes
the driver to copy all available data from the device to the <ACRONYM
CLASS="ACRONYM"
>Comedi</ACRONYM
>
buffer.  In addition, some drivers may use a polling technique in
place of interrupts.
      </P
></DD
></DL
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="r6633.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>&nbsp;</TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>comedi_get_softcal_converter</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
>&nbsp;</TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>&nbsp;</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>