git: 38c1959b6a - main - doc: Update source files (en .po), for translations
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Sun, 04 Sep 2022 00:31:41 UTC
The branch main has been updated by dbaio:
URL: https://cgit.FreeBSD.org/doc/commit/?id=38c1959b6a2ec7a8323ac9d447a62b87061a54c0
commit 38c1959b6a2ec7a8323ac9d447a62b87061a54c0
Author: Danilo G. Baio <dbaio@FreeBSD.org>
AuthorDate: 2022-09-04 00:31:08 +0000
Commit: Danilo G. Baio <dbaio@FreeBSD.org>
CommitDate: 2022-09-04 00:31:08 +0000
doc: Update source files (en .po), for translations
---
.../content/en/articles/contributors/_index.po | 40 +-
.../content/en/books/arch-handbook/isa/_index.po | 448 ++++++++++-----------
2 files changed, 240 insertions(+), 248 deletions(-)
diff --git a/documentation/content/en/articles/contributors/_index.po b/documentation/content/en/articles/contributors/_index.po
index 5b0e861eac..faa9f81533 100644
--- a/documentation/content/en/articles/contributors/_index.po
+++ b/documentation/content/en/articles/contributors/_index.po
@@ -7,7 +7,7 @@
msgid ""
msgstr ""
"Project-Id-Version: FreeBSD Documentation VERSION\n"
-"POT-Creation-Date: 2022-07-07 23:23-0300\n"
+"POT-Creation-Date: 2022-09-03 21:28-0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -98,23 +98,23 @@ msgstr ""
#. type: Plain text
#: documentation/content/en/articles/contributors/_index.adoc:87
msgid ""
-"Joe McGuckin mailto:joe@via.net[joe@via.net] of http://www.via.net/[ViaNet "
+"Joe McGuckin <mailto:joe@via.net[joe@via.net]> of http://www.via.net/[ViaNet "
"Communications] donated a _Kingston ethernet controller._"
msgstr ""
#. type: Plain text
#: documentation/content/en/articles/contributors/_index.adoc:88
msgid ""
-"Jack O'Neill mailto:jack@diamond.xtalwind.net[jack@diamond.xtalwind.net] "
+"Jack O'Neill <mailto:jack@diamond.xtalwind.net[jack@diamond.xtalwind.net]> "
"donated an _NCR 53C875 SCSI controller card_."
msgstr ""
#. type: Plain text
#: documentation/content/en/articles/contributors/_index.adoc:89
msgid ""
-"Ulf Zimmermann mailto:ulf@Alameda.net[ulf@Alameda.net] of http://www.Alameda."
-"net/[Alameda Networks] donated _128MB of memory_, a _4 Gb disk drive and the "
-"case._"
+"Ulf Zimmermann <mailto:ulf@Alameda.net[ulf@Alameda.net]> of http://www."
+"Alameda.net/[Alameda Networks] donated _128MB of memory_, a _4 Gb disk drive "
+"and the case._"
msgstr ""
#. type: Plain text
@@ -132,8 +132,8 @@ msgstr ""
#. type: Plain text
#: documentation/content/en/articles/contributors/_index.adoc:95
msgid ""
-"Annelise Anderson mailto:ANDRSN@HOOVER.STANFORD.EDU[ANDRSN@HOOVER.STANFORD."
-"EDU]"
+"Annelise Anderson <mailto:ANDRSN@HOOVER.STANFORD.EDU[ANDRSN@HOOVER.STANFORD."
+"EDU]>"
msgstr ""
#. type: Plain text
@@ -168,12 +168,12 @@ msgstr ""
#. type: Plain text
#: documentation/content/en/articles/contributors/_index.adoc:102
-msgid "Gianmarco Giovannelli mailto:gmarco@masternet.it[gmarco@masternet.it]"
+msgid "Gianmarco Giovannelli <mailto:gmarco@masternet.it[gmarco@masternet.it]>"
msgstr ""
#. type: Plain text
#: documentation/content/en/articles/contributors/_index.adoc:103
-msgid "Josef C. Grosch mailto:joeg@truenorth.org[joeg@truenorth.org]"
+msgid "Josef C. Grosch <mailto:joeg@truenorth.org[joeg@truenorth.org]>"
msgstr ""
#. type: Plain text
@@ -189,13 +189,13 @@ msgstr ""
#. type: Plain text
#: documentation/content/en/articles/contributors/_index.adoc:106
msgid ""
-"Kenneth P. Stox mailto:ken@stox.sa.enteract.com[ken@stox.sa.enteract.com] of "
-"http://www.imagescape.com/[Imaginary Landscape, LLC.]"
+"Kenneth P. Stox <mailto:ken@stox.sa.enteract.com[ken@stox.sa.enteract.com]> "
+"of http://www.imagescape.com/[Imaginary Landscape, LLC.]"
msgstr ""
#. type: Plain text
#: documentation/content/en/articles/contributors/_index.adoc:107
-msgid "Dmitry S. Kohmanyuk mailto:dk@dog.farm.org[dk@dog.farm.org]"
+msgid "Dmitry S. Kohmanyuk <mailto:dk@dog.farm.org[dk@dog.farm.org]>"
msgstr ""
#. type: Plain text
@@ -240,13 +240,13 @@ msgstr ""
#. type: Plain text
#: documentation/content/en/articles/contributors/_index.adoc:114
msgid ""
-"http://www.siemens.de/[Siemens AG] via Andre Albsmeier mailto:andre."
-"albsmeier@mchp.siemens.de[andre.albsmeier@mchp.siemens.de]"
+"http://www.siemens.de/[Siemens AG] via Andre Albsmeier <mailto:andre."
+"albsmeier@mchp.siemens.de[andre.albsmeier@mchp.siemens.de]>"
msgstr ""
#. type: Plain text
#: documentation/content/en/articles/contributors/_index.adoc:115
-msgid "Chris Silva mailto:ras@interaccess.com[ras@interaccess.com]"
+msgid "Chris Silva <mailto:ras@interaccess.com[ras@interaccess.com]>"
msgstr ""
#. type: Plain text
@@ -298,14 +298,14 @@ msgstr ""
#. type: Plain text
#: documentation/content/en/articles/contributors/_index.adoc:125
msgid ""
-"Chuck Robey mailto:chuckr@glue.umd.edu[chuckr@glue.umd.edu] contributed his "
-"floppy tape streamer for experimental work."
+"Chuck Robey <mailto:chuckr@glue.umd.edu[chuckr@glue.umd.edu]> contributed "
+"his floppy tape streamer for experimental work."
msgstr ""
#. type: Plain text
#: documentation/content/en/articles/contributors/_index.adoc:126
msgid ""
-"Larry Altneu mailto:larry@ALR.COM[larry@ALR.COM], and {wilko}, provided "
+"Larry Altneu <mailto:larry@ALR.COM[larry@ALR.COM],> and {wilko}, provided "
"Wangtek and Archive QIC-02 tape drives in order to improve the [."
"filename]#wt# driver."
msgstr ""
@@ -349,7 +349,7 @@ msgstr ""
#. type: Plain text
#: documentation/content/en/articles/contributors/_index.adoc:131
msgid ""
-"Mike Tancsa mailto:mike@sentex.ca[mike@sentex.ca] donated four various ATM "
+"Mike Tancsa <mailto:mike@sentex.ca[mike@sentex.ca]> donated four various ATM "
"PCI cards in order to help increase support of these cards as well as help "
"support the development effort of the netatm ATM stack."
msgstr ""
diff --git a/documentation/content/en/books/arch-handbook/isa/_index.po b/documentation/content/en/books/arch-handbook/isa/_index.po
index c64f3e28f7..44349fdc20 100644
--- a/documentation/content/en/books/arch-handbook/isa/_index.po
+++ b/documentation/content/en/books/arch-handbook/isa/_index.po
@@ -7,7 +7,7 @@
msgid ""
msgstr ""
"Project-Id-Version: FreeBSD Documentation VERSION\n"
-"POT-Creation-Date: 2022-02-01 09:20-0300\n"
+"POT-Creation-Date: 2022-09-03 21:28-0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@@ -1218,7 +1218,7 @@ msgstr ""
#. type: Plain text
#: documentation/content/en/books/arch-handbook/isa/_index.adoc:368
-msgid "_flags_ - a bitmap of flags. The only interesting flags are:"
+msgid "_flags_ - a bitmap of flags. The only interesting flag is:"
msgstr ""
#. type: Plain text
@@ -1229,42 +1229,34 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:371
-msgid ""
-"_BUS_DMA_ISA_ - mysterious flag used only on Alpha machines. It is not "
-"defined for the i386 machines. Probably it should be used by all the ISA "
-"drivers for Alpha machines but it looks like there are no such drivers yet."
-msgstr ""
-
-#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:373
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:372
msgid "_dmat_ - pointer to the storage for the new tag to be returned."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:375
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:374
msgid "`int bus_dma_tag_destroy(bus_dma_tag_t dmat)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:377
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:376
msgid "Destroy a tag. Returns 0 on success, the error code otherwise."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:379
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:378
msgid "dmat - the tag to be destroyed."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:380
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:379
msgid ""
"`int bus_dmamem_alloc(bus_dma_tag_t dmat, void** vaddr, int flags, "
"bus_dmamap_t *mapp)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:382
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:381
msgid ""
"Allocate an area of contiguous memory described by the tag. The size of "
"memory to be allocated is tag's maxsize. Returns 0 on success, the error "
@@ -1273,27 +1265,27 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:384
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:396
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:404
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:419
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:383
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:395
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:403
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:418
msgid "_dmat_ - the tag"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:385
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:384
msgid ""
"_vaddr_ - pointer to the storage for the kernel virtual address of the "
"allocated area to be returned."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:386
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:385
msgid "flags - a bitmap of flags. The only interesting flag is:"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:388
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:387
msgid ""
"_BUS_DMA_NOWAIT_ - if the memory is not immediately available return the "
"error. If this flag is not set then the routine is allowed to sleep until "
@@ -1301,18 +1293,18 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:390
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:389
msgid "_mapp_ - pointer to the storage for the new map to be returned."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:392
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:391
msgid ""
"`void bus_dmamem_free(bus_dma_tag_t dmat, void *vaddr, bus_dmamap_t map)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:394
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:393
msgid ""
"Free the memory allocated by `bus_dmamem_alloc()`. At present, freeing of "
"the memory allocated with ISA restrictions is not implemented. Due to this "
@@ -1323,62 +1315,62 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:397
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:396
msgid "_vaddr_ - the kernel virtual address of the memory"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:398
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:397
msgid "_map_ - the map of the memory (as returned from `bus_dmamem_alloc()`)"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:400
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:399
msgid ""
"`int bus_dmamap_create(bus_dma_tag_t dmat, int flags, bus_dmamap_t *mapp)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:402
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:401
msgid ""
"Create a map for the tag, to be used in `bus_dmamap_load()` later. Returns 0 "
"on success, the error code otherwise."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:405
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:404
msgid ""
"_flags_ - theoretically, a bit map of flags. But no flags are defined yet, "
"so at present it will be always 0."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:406
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:405
msgid "_mapp_ - pointer to the storage for the new map to be returned"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:408
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:407
msgid "`int bus_dmamap_destroy(bus_dma_tag_t dmat, bus_dmamap_t map)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:410
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:409
msgid "Destroy a map. Returns 0 on success, the error code otherwise."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:412
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:411
msgid "dmat - the tag to which the map is associated"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:413
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:412
msgid "map - the map to be destroyed"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:415
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:414
msgid ""
"`int bus_dmamap_load(bus_dma_tag_t dmat, bus_dmamap_t map, void *buf, "
"bus_size_t buflen, bus_dmamap_callback_t *callback, void *callback_arg, int "
@@ -1386,7 +1378,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:417
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:416
msgid ""
"Load a buffer into the map (the map must be previously created by "
"`bus_dmamap_create()` or `bus_dmamem_alloc()`). All the pages of the buffer "
@@ -1403,49 +1395,49 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:420
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:419
msgid "_map_ - the map"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:421
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:420
msgid "_buf_ - kernel virtual address of the buffer"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:422
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:421
msgid "_buflen_ - length of the buffer"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:423
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:422
msgid "_callback_, `callback_arg` - the callback function and its argument"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:425
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:424
msgid ""
"The prototype of callback function is: `void callback(void *arg, "
"bus_dma_segment_t *seg, int nseg, int error)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:427
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:426
msgid "_arg_ - the same as callback_arg passed to `bus_dmamap_load()`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:428
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:427
msgid "_seg_ - array of the segment descriptors"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:429
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:428
msgid "_nseg_ - number of descriptors in array"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:430
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:429
msgid ""
"_error_ - indication of the segment number overflow: if it is set to `EFBIG` "
"then the buffer did not fit into the maximal number of segments permitted by "
@@ -1456,51 +1448,51 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:432
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:431
msgid "Each entry in the segments array contains the fields:"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:434
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:433
msgid "_ds_addr_ - physical bus address of the segment"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:435
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:434
msgid "_ds_len_ - length of the segment"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:437
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:436
msgid "`void bus_dmamap_unload(bus_dma_tag_t dmat, bus_dmamap_t map)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:439
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:438
msgid "unload the map."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:441
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:448
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:440
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:447
msgid "_dmat_ - tag"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:442
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:449
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:441
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:448
msgid "_map_ - loaded map"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:444
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:443
msgid ""
"`void bus_dmamap_sync (bus_dma_tag_t dmat, bus_dmamap_t map, "
"bus_dmasync_op_t op)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:446
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:445
msgid ""
"Synchronise a loaded buffer with its bounce pages before and after physical "
"transfer to or from device. This is the function that does all the necessary "
@@ -1509,32 +1501,32 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:450
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:449
msgid "_op_ - type of synchronization operation to perform:"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:452
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:451
msgid "`BUS_DMASYNC_PREREAD` - before reading from device into buffer"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:453
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:452
msgid "`BUS_DMASYNC_POSTREAD` - after reading from device into buffer"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:454
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:453
msgid "`BUS_DMASYNC_PREWRITE` - before writing the buffer to device"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:455
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:454
msgid "`BUS_DMASYNC_POSTWRITE` - after writing the buffer to device"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:457
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:456
msgid ""
"As of now PREREAD and POSTWRITE are null operations but that may change in "
"the future, so they must not be ignored in the driver. Synchronization is "
@@ -1542,7 +1534,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:459
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:458
msgid ""
"Before calling the callback function from `bus_dmamap_load()` the segment "
"array is stored in the stack. And it gets pre-allocated for the maximal "
@@ -1559,7 +1551,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:461
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:460
msgid ""
"Another practical consequence is that the number of segments may limit the "
"size of the buffer. If all the pages in the buffer happen to be physically "
@@ -1571,7 +1563,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:463
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:462
msgid ""
"If the hardware does not support scatter-gather at all or the driver wants "
"to support some buffer size even if it is heavily fragmented then the "
@@ -1580,34 +1572,34 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:465
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:464
msgid ""
"Below are the typical call sequences when using a map depend on the use of "
"the map. The characters -> are used to show the flow of time."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:467
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:466
msgid ""
"For a buffer which stays practically fixed during all the time between "
"attachment and detachment of a device:"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:469
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:468
msgid ""
"bus_dmamem_alloc -> bus_dmamap_load -> ...use buffer... -> -> "
"bus_dmamap_unload -> bus_dmamem_free"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:471
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:470
msgid ""
"For a buffer that changes frequently and is passed from outside the driver:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:480
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:479
#, no-wrap
msgid ""
" bus_dmamap_create ->\n"
@@ -1620,7 +1612,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:483
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:482
msgid ""
"When loading a map created by `bus_dmamem_alloc()` the passed address and "
"size of the buffer must be the same as used in `bus_dmamem_alloc()`. In this "
@@ -1631,12 +1623,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:485
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:484
msgid "A typical example would be:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:493
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:492
#, no-wrap
msgid ""
" static void\n"
@@ -1647,7 +1639,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:504
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:503
#, no-wrap
msgid ""
" ...\n"
@@ -1663,7 +1655,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:512
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:511
#, no-wrap
msgid ""
" error=bus_dma_tag_create(parent_tag, alignment,\n"
@@ -1676,7 +1668,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:517
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:516
#, no-wrap
msgid ""
" error = bus_dmamem_alloc(tag_somedata, &vsomedata, /* flags*/ 0,\n"
@@ -1686,7 +1678,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:521
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:520
#, no-wrap
msgid ""
" bus_dmamap_load(tag_somedata, map_somedata, (void *)vsomedata,\n"
@@ -1695,7 +1687,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:524
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:523
msgid ""
"Looks a bit long and complicated but that is the way to do it. The practical "
"consequence is: if multiple memory areas are allocated always together it "
@@ -1704,7 +1696,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:526
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:525
msgid ""
"When loading an arbitrary buffer into the map created by "
"`bus_dmamap_create()` special measures must be taken to synchronize with the "
@@ -1712,7 +1704,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:532
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:531
#, no-wrap
msgid ""
" {\n"
@@ -1721,7 +1713,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:551
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:550
#, no-wrap
msgid ""
" s = splsoftvm();\n"
@@ -1745,12 +1737,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:554
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:553
msgid "Two possible approaches for the processing of requests are:"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:556
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:555
msgid ""
"If requests are completed by marking them explicitly as done (such as the "
"CAM requests) then it would be simpler to put all the further processing "
@@ -1761,7 +1753,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:558
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:557
msgid ""
"If requests are completed when the function returns (such as classic read or "
"write requests on character devices) then a synchronization flag should be "
@@ -1775,13 +1767,13 @@ msgid ""
msgstr ""
#. type: Title ==
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:560
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:559
#, no-wrap
msgid "DMA"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:563
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:562
msgid ""
"The Direct Memory Access (DMA) is implemented in the ISA bus through the DMA "
"controller (actually, two of them but that is an irrelevant detail). To make "
@@ -1792,7 +1784,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:565
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:564
msgid ""
"The simplest case is for the fairly intelligent devices. Like the bus master "
"devices on PCI they can generate the bus cycles and memory addresses all by "
@@ -1804,30 +1796,30 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:567
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:566
msgid "`void isa_dmacascade(int channel_number)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:569
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:568
msgid ""
"All the further activity is done by programming the device. When detaching "
"the driver no DMA-related functions need to be called."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:571
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:570
msgid ""
"For the simpler devices things get more complicated. The functions used are:"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:573
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:572
msgid "`int isa_dma_acquire(int chanel_number)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:575
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:574
msgid ""
"Reserve a DMA channel. Returns 0 on success or EBUSY if the channel was "
"already reserved by this or a different driver. Most of the ISA devices are "
@@ -1838,12 +1830,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:576
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:575
msgid "`int isa_dma_release(int chanel_number)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:578
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:577
msgid ""
"Release a previously reserved DMA channel. No transfers must be in progress "
"when the channel is released (in addition the device must not try to "
@@ -1851,12 +1843,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:579
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:578
msgid "`void isa_dmainit(int chan, u_int bouncebufsize)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:581
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:580
msgid ""
"Allocate a bounce buffer for use with the specified channel. The requested "
"size of the buffer can not exceed 64KB. This bounce buffer will be "
@@ -1871,22 +1863,22 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:583
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:582
msgid "_chan_ - channel number"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:584
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:583
msgid "_bouncebufsize_ - size of the bounce buffer in bytes"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:586
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:585
msgid "`void isa_dmastart(int flags, caddr_t addr, u_int nbytes, int chan)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:588
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:587
msgid ""
"Prepare to start a DMA transfer. This function must be called to set up the "
"DMA controller before actually starting transfer on the device. It checks "
@@ -1898,24 +1890,24 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:589
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:588
msgid ""
"flags - a bitmask determining the type of operation to be done. The "
"direction bits B_READ and B_WRITE are mutually exclusive."
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:591
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:590
msgid "B_READ - read from the ISA bus into memory"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:592
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:591
msgid "B_WRITE - write from the memory to the ISA bus"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:593
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:592
msgid ""
"B_RAW - if set then the DMA controller will remember the buffer and after "
"the end of transfer will automatically re-initialize itself to repeat "
@@ -1927,12 +1919,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:595
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:594
msgid "addr - virtual address of the buffer"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:596
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:595
msgid ""
"nbytes - length of the buffer. Must be less or equal to 64KB. Length of 0 is "
"not allowed: the DMA controller will understand it as 64KB while the kernel "
@@ -1943,17 +1935,17 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:597
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:596
msgid "chan - channel number"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:598
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:597
msgid "`void isa_dmadone(int flags, caddr_t addr, int nbytes, int chan)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:600
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:599
msgid ""
"Synchronize the memory after device reports that transfer is done. If that "
"was a read operation with a bounce buffer then the data will be copied from "
@@ -1963,12 +1955,12 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:601
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:600
msgid "`int isa_dmastatus(int channel_number)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:603
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:602
msgid ""
"Returns the number of bytes left in the current transfer to be transferred. "
"In case the flag B_READ was set in `isa_dmastart()` the number returned will "
@@ -1980,25 +1972,25 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:604
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:603
msgid "`int isa_dmastop(int channel_number)`"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:606
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:605
msgid ""
"Aborts the current transfer and returns the number of bytes left "
"untransferred."
msgstr ""
#. type: Title ==
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:608
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:607
#, no-wrap
msgid "xxx_isa_probe"
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:611
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:610
msgid ""
"This function probes if a device is present. If the driver supports auto-"
"detection of some part of device configuration (such as interrupt vector or "
@@ -2006,7 +1998,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:613
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:612
msgid ""
"As for any other bus, if the device cannot be detected or is detected but "
"failed the self-test or some other problem happened then it returns a "
@@ -2016,7 +2008,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:615
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:614
msgid ""
"The negative return values are used when a PnP device supports multiple "
"interfaces. For example, an older compatibility interface and a newer "
@@ -2031,7 +2023,7 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:617
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:616
msgid ""
"The device descriptor struct xxx_softc is allocated by the system before "
"calling the probe routine. If the probe routine returns an error the "
@@ -2052,13 +2044,13 @@ msgid ""
msgstr ""
#. type: Plain text
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:619
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:618
msgid ""
"A typical probe routine starts with getting the device descriptor and unit:"
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:626
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:625
#, no-wrap
msgid ""
" struct xxx_softc *sc = device_get_softc(dev);\n"
@@ -2068,7 +2060,7 @@ msgid ""
msgstr ""
#. type: delimited block . 4
-#: documentation/content/en/books/arch-handbook/isa/_index.adoc:629
+#: documentation/content/en/books/arch-handbook/isa/_index.adoc:628
#, no-wrap
msgid ""
" sc->dev = dev; /* link it back */\n"
@@ -2076,7 +2068,7 @@ msgid ""
msgstr ""
*** 877 LINES SKIPPED ***