diff options
| author | Vladlen Popolitov <vladlen@FreeBSD.org> | 2026-08-12 14:50:06 +0000 |
|---|---|---|
| committer | Vladlen Popolitov <vladlen@FreeBSD.org> | 2026-08-12 14:50:06 +0000 |
| commit | 8434b998ebcda473eae45ddd86875776aaaddcff (patch) | |
| tree | f8f4fe6d2f7294da9fe763137e73823b93792103 | |
| parent | 7269df3b49ea141ef5e66a2106745d11ea9b8931 (diff) | |
update translation of books/developers-handbook to Russian
Differential Revision: https://reviews.freebsd.org/D58797
13 files changed, 1006 insertions, 12160 deletions
diff --git a/documentation/content/ru/books/developers-handbook/ipv6/_index.adoc b/documentation/content/ru/books/developers-handbook/ipv6/_index.adoc index e781349bb7..f751e2a094 100644 --- a/documentation/content/ru/books/developers-handbook/ipv6/_index.adoc +++ b/documentation/content/ru/books/developers-handbook/ipv6/_index.adoc @@ -217,7 +217,7 @@ fe80:1::%ed0/64 link#1 UC ed0 fe80:2::%ep0/64 link#2 UC ep0 .... -Интерфейсы, не имеющие адреса IEEE802 (псевдоинтерфейсы, такие как туннельные интерфейсы или интерфейсы ppp), будут заимствовать адрес IEEE802 у других интерфейсов, например, Ethernet-интерфейсов, когда это возможно. Если нет подключенного оборудования IEEE802, в качестве последнего средства будет использовано псевдослучайное значение MD5(hostname) для формирования линк-локального адреса. Если это не подходит для вашего использования, вам потребуется настроить линк-локальный адрес вручную. +Интерфейсы, не имеющие адреса IEEE802 (псевдоинтерфейсы, такие как туннельные интерфейсы или интерфейсы ppp), будут заимствовать адрес IEEE802 у других интерфейсов, например, Ethernet-интерфейсов, когда это возможно. Если нет подключённого оборудования IEEE802, в качестве последнего средства будет использовано псевдослучайное значение MD5(hostname) для формирования линк-локального адреса. Если это не подходит для вашего использования, вам потребуется настроить линк-локальный адрес вручную. Если интерфейс не поддерживает IPv6 (например, отсутствует поддержка multicast), на этот интерфейс не будет назначен линк-локальный адрес. Подробности см. в разделе 2. @@ -479,7 +479,7 @@ FreeBSD 4.x поддерживает исходящее соединение с ==== sockaddr_storage -Когда RFC2553 был близок к завершению, велись дискуссии о том, как называть элементы структуры `sockaddr_storage`. Одно предложение заключалось в добавлении "__" перед именами элементов (например, "__ss_len"), так как к ним не следует обращаться напрямую. Другое предложение было не добавлять префикс (например, "ss_len"), поскольку необходимо прямое обращение к этим элементам. Четкого консенсуса по этому вопросу достигнуто не было. +Когда RFC2553 был близок к завершению, велись дискуссии о том, как называть элементы структуры `sockaddr_storage`. Одно предложение заключалось в добавлении "__" перед именами элементов (например, "__ss_len"), так как к ним не следует обращаться напрямую. Другое предложение было не добавлять префикс (например, "ss_len"), поскольку необходимо прямое обращение к этим элементам. Чёткого консенсуса по этому вопросу достигнуто не было. В результате, RFC2553 определяет структуру sockaddr_storage следующим образом: diff --git a/documentation/content/ru/books/developers-handbook/ipv6/_index.po b/documentation/content/ru/books/developers-handbook/ipv6/_index.po index 4371e21dbe..4cf4e5ce64 100644 --- a/documentation/content/ru/books/developers-handbook/ipv6/_index.po +++ b/documentation/content/ru/books/developers-handbook/ipv6/_index.po @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2025-11-08 16:17+0000\n" -"PO-Revision-Date: 2026-03-04 20:01+0000\n" +"POT-Creation-Date: 2026-08-06 22:55+0100\n" +"PO-Revision-Date: 2026-05-18 04:45+0000\n" "Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n" "Language-Team: Russian <https://translate-dev.freebsd.org/projects/" "documentation/booksdevelopers-handbookipv6_index/ru/>\n" @@ -14,8 +14,8 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && " -"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" +"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n" +"%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" "X-Generator: Weblate 4.17\n" #. type: Title = @@ -32,13 +32,13 @@ msgid "Chapter 8. IPv6 Internals" msgstr "Глава 8. Внутреннее устройство IPv6" #. type: Title == -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:54 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:53 #, no-wrap msgid "IPv6/IPsec Implementation" msgstr "Реализация IPv6/IPsec" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:58 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:57 msgid "" "This section should explain IPv6 and IPsec related implementation " "internals. These functionalities are derived from http://www.kame.net/[KAME " @@ -48,19 +48,19 @@ msgstr "" "Данная функциональность заимствована из http://www.kame.net/[проекта KAME]" #. type: Title === -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:60 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:59 #, no-wrap msgid "IPv6" msgstr "IPv6" #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:62 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:61 #, no-wrap msgid "Conformance" msgstr "Соответствие" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:66 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:65 msgid "" "The IPv6 related functions conforms, or tries to conform to the latest set " "of IPv6 specifications. For future reference we list some of the relevant " @@ -73,7 +73,7 @@ msgstr "" "полный список — его слишком сложно поддерживать...)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:68 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:67 msgid "" "For details please refer to specific chapter in the document, RFCs, manual " "pages, or comments in the source code." @@ -82,7 +82,7 @@ msgstr "" "страницам Справочника или комментариям в исходном коде." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:72 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:71 msgid "" "Conformance tests have been performed on the KAME STABLE kit at TAHI " "project. Results can be viewed at http://www.tahi.org/report/KAME/[http://" @@ -97,13 +97,13 @@ msgstr "" "в прошлом, используя наши предыдущие версии." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:74 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:73 msgid "RFC1639: FTP Operation Over Big Address Records (FOOBAR)" msgstr "RFC1639: FTP Operation Over Big Address Records (FOOBAR)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:76 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:113 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:75 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:112 msgid "" "RFC2428 is preferred over RFC1639. FTP clients will first try RFC2428, then " "RFC1639 if failed." @@ -112,29 +112,29 @@ msgstr "" "затем RFC1639 в случае неудачи." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:78 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:77 msgid "RFC1886: DNS Extensions to support IPv6" msgstr "RFC1886: DNS Extensions to support IPv6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:79 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:78 msgid "RFC1933: Transition Mechanisms for IPv6 Hosts and Routers" msgstr "RFC1933: Transition Mechanisms for IPv6 Hosts and Routers" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:81 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:80 msgid "IPv4 compatible address is not supported." msgstr "IPv4-совместимый адрес не поддерживается." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:82 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:81 msgid "automatic tunneling (described in 4.3 of this RFC) is not supported." msgstr "" "автоматическое туннелирование (описано в разделе 4.3 данного RFC) не " "поддерживается." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:84 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:83 msgid "" "man:gif[4] interface implements IPv[46]-over-IPv[46] tunnel in a generic " "way, and it covers \"configured tunnel\" described in the spec. See crossref:" @@ -146,27 +146,27 @@ msgstr "" "этого документа." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:86 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:85 msgid "RFC1981: Path MTU Discovery for IPv6" msgstr "RFC1981: Path MTU Discovery for IPv6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:87 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:86 msgid "RFC2080: RIPng for IPv6" msgstr "RFC2080: RIPng for IPv6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:89 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:88 msgid "usr.sbin/route6d support this." msgstr "usr.sbin/route6d это поддерживает." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:91 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:90 msgid "RFC2292: Advanced Sockets API for IPv6" msgstr "RFC2292: Advanced Sockets API for IPv6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:93 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:92 msgid "" "For supported library functions/kernel APIs, see [.filename]#sys/netinet6/" "ADVAPI#." @@ -175,12 +175,12 @@ msgstr "" "ADVAPI#." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:95 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:94 msgid "RFC2362: Protocol Independent Multicast-Sparse Mode (PIM-SM)" msgstr "RFC2362: Protocol Independent Multicast-Sparse Mode (PIM-SM)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:97 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:96 msgid "" "RFC2362 defines packet formats for PIM-SM. [.filename]#draft-ietf-pim-" "ipv6-01.txt# is written based on this." @@ -189,12 +189,12 @@ msgstr "" "ipv6-01.txt# написан на основе этого." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:99 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:98 msgid "RFC2373: IPv6 Addressing Architecture" msgstr "RFC2373: IPv6 Addressing Architecture" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:101 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:100 msgid "" "supports node required addresses, and conforms to the scope requirement." msgstr "" @@ -202,44 +202,44 @@ msgstr "" "видимости." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:103 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:102 msgid "RFC2374: An IPv6 Aggregatable Global Unicast Address Format" msgstr "RFC2374: An IPv6 Aggregatable Global Unicast Address Format" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:105 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:104 msgid "supports 64-bit length of Interface ID." msgstr "поддерживает 64-битную длину Идентификатора Интерфейса." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:107 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:106 msgid "RFC2375: IPv6 Multicast Address Assignments" msgstr "RFC2375: IPv6 Multicast Address Assignments" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:109 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:108 msgid "Userland applications use the well-known addresses assigned in the RFC." msgstr "" "Пользовательские приложения используют общеизвестные адреса, назначенные в " "RFC." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:111 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:110 msgid "RFC2428: FTP Extensions for IPv6 and NATs" msgstr "RFC2428: FTP Extensions for IPv6 and NATs" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:115 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:114 msgid "RFC2460: IPv6 specification" msgstr "RFC2460: IPv6 specification" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:116 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:115 msgid "RFC2461: Neighbor discovery for IPv6" msgstr "RFC2461: Neighbor discovery for IPv6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:118 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:117 msgid "" "See crossref:ipv6[neighbor-discovery,Neighbor Discovery] in this document " "for details." @@ -248,40 +248,40 @@ msgstr "" "в этом документе для получения подробностей." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:120 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:119 msgid "RFC2462: IPv6 Stateless Address Autoconfiguration" msgstr "RFC2462: IPv6 Stateless Address Autoconfiguration" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:122 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:121 msgid "See crossref:ipv6[ipv6-pnp,Plug and Play] in this document for details." msgstr "" "См. раздел crossref:ipv6[ipv6-pnp,Plug and Play (подключи и работай)] в этом " "документе для получения подробностей." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:124 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:123 msgid "RFC2463: ICMPv6 for IPv6 specification" msgstr "RFC2463: ICMPv6 for IPv6 specification" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:126 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:125 msgid "See crossref:ipv6[icmpv6,ICMPv6] in this document for details." msgstr "" "См. crossref:ipv6[icmpv6,ICMPv6] в этом документе для получения подробностей." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:128 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:127 msgid "RFC2464: Transmission of IPv6 Packets over Ethernet Networks" msgstr "RFC2464: Transmission of IPv6 Packets over Ethernet Networks" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:129 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:128 msgid "RFC2465: MIB for IPv6: Textual Conventions and General Group" msgstr "RFC2465: MIB for IPv6: Textual Conventions and General Group" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:131 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:130 msgid "" "Necessary statistics are gathered by the kernel. Actual IPv6 MIB support is " "provided as a patchkit for ucd-snmp." @@ -290,12 +290,12 @@ msgstr "" "предоставляется в виде набора патчей для ucd-snmp." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:133 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:132 msgid "RFC2466: MIB for IPv6: ICMPv6 group" msgstr "RFC2466: MIB for IPv6: ICMPv6 group" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:135 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:134 msgid "" "Necessary statistics are gathered by the kernel. Actual IPv6 MIB support is " "provided as patchkit for ucd-snmp." @@ -304,22 +304,22 @@ msgstr "" "предоставляется в виде патча для ucd-snmp." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:137 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:136 msgid "RFC2467: Transmission of IPv6 Packets over FDDI Networks" msgstr "RFC2467: Transmission of IPv6 Packets over FDDI Networks" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:138 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:137 msgid "RFC2497: Transmission of IPv6 packet over ARCnet Networks" msgstr "RFC2497: Transmission of IPv6 packet over ARCnet Networks" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:139 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:138 msgid "RFC2553: Basic Socket Interface Extensions for IPv6" msgstr "RFC2553: Basic Socket Interface Extensions for IPv6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:142 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:141 msgid "" "IPv4 mapped address (3.7) and special behavior of IPv6 wildcard bind socket " "(3.8) are supported. See crossref:ipv6[ipv6-wildcard-socket,IPv4 Mapped " @@ -331,12 +331,12 @@ msgstr "" "подстановочным адресом]." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:144 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:143 msgid "RFC2675: IPv6 Jumbograms" msgstr "RFC2675: IPv6 Jumbograms" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:146 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:145 msgid "" "See crossref:ipv6[ipv6-jumbo,Jumbo Payload] in this document for details." msgstr "" @@ -344,17 +344,17 @@ msgstr "" "документе для получения подробностей." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:148 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:147 msgid "RFC2710: Multicast Listener Discovery for IPv6" msgstr "RFC2710: Multicast Listener Discovery for IPv6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:149 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:148 msgid "RFC2711: IPv6 router alert option" msgstr "RFC2711: IPv6 router alert option" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:150 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:149 msgid "" "[.filename]#draft-ietf-ipngwg-router-renum-08#: Router renumbering for IPv6" msgstr "" @@ -362,7 +362,7 @@ msgstr "" "маршрутизаторов для IPv6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:151 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:150 msgid "" "[.filename]#draft-ietf-ipngwg-icmp-namelookups-02#: IPv6 Name Lookups " "Through ICMP" @@ -371,7 +371,7 @@ msgstr "" "IPv6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:152 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:151 msgid "" "[.filename]#draft-ietf-ipngwg-icmp-name-lookups-03#: IPv6 Name Lookups " "Through ICMP" @@ -380,12 +380,12 @@ msgstr "" "ICMP" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:153 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:152 msgid "[.filename]#draft-ietf-pim-ipv6-01.txt#: PIM for IPv6" msgstr "[.filename]#draft-ietf-pim-ipv6-01.txt#: PIM for IPv6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:155 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:154 msgid "" "man:pim6dd[8] implements dense mode. man:pim6sd[8] implements sparse mode." msgstr "" @@ -393,7 +393,7 @@ msgstr "" "режим." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:157 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:156 msgid "" "[.filename]#draft-itojun-ipv6-tcp-to-anycast-00#: Disconnecting TCP " "connection toward IPv6 anycast address" @@ -402,12 +402,12 @@ msgstr "" "anycast-адресом IPv6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:158 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:157 msgid "[.filename]#draft-yamamoto-wideipv6-comm-model-00#" msgstr "[.filename]#draft-yamamoto-wideipv6-comm-model-00#" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:160 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:159 msgid "" "See crossref:ipv6[ipv6-sas,Source Address Selection] in this document for " "details." @@ -416,7 +416,7 @@ msgstr "" "для более подробной информации." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:162 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:161 msgid "" "[.filename]#draft-ietf-ipngwg-scopedaddr-format-00.txt#: An Extension of " "Format for IPv6 Scoped Addresses" @@ -425,13 +425,13 @@ msgstr "" "для адресов с областью действия IPv6" #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:164 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:163 #, no-wrap msgid "Neighbor Discovery" msgstr "Функция \"Обнаружение соседей\"" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:169 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:168 msgid "" "Neighbor Discovery is fairly stable. Currently Address Resolution, " "Duplicated Address Detection, and Neighbor Unreachability Detection are " @@ -448,7 +448,7 @@ msgstr "" "(Unsolicited Neighbor Advertisement) в качестве инструмента администратора." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:174 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:173 msgid "" "If DAD fails, the address will be marked \"duplicated\" and message will be " "generated to syslog (and usually to console). The \"duplicated\" mark can " @@ -463,7 +463,7 @@ msgstr "" "ближайшем будущем поведение должно быть улучшено." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:178 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:177 msgid "" "Some of the network driver loops multicast packets back to itself, even if " "instructed not to do so (especially in promiscuous mode). In such cases DAD " @@ -482,7 +482,7 @@ msgstr "" "что фрагмент кода в разделе \"heuristics\" не соответствует спецификации)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:180 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:179 msgid "" "Neighbor Discovery specification (RFC2461) does not talk about neighbor " "cache handling in the following cases:" @@ -491,7 +491,7 @@ msgstr "" "соседей в следующих случаях:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:182 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:181 msgid "" "when there was no neighbor cache entry, node received unsolicited RS/NS/NA/" "redirect packet without link-layer address" @@ -500,7 +500,7 @@ msgstr "" "RS/NS/NA/редирект без адреса канального уровня" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:183 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:182 msgid "" "neighbor cache handling on medium without link-layer address (we need a " "neighbor cache entry for IsRouter bit)" @@ -509,7 +509,7 @@ msgstr "" "запись в кэше соседей для бита IsRouter)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:186 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:185 msgid "" "For first case, we implemented workaround based on discussions on IETF " "ipngwg mailing list. For more details, see the comments in the source code " @@ -520,7 +520,7 @@ msgstr "" "и ветке электронной почты, начавшейся с (IPng 7155) от 6 февраля 1999 года." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:189 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:188 msgid "" "IPv6 on-link determination rule (RFC2461) is quite different from " "assumptions in BSD network code. At this moment, no on-link determination " @@ -536,7 +536,7 @@ msgstr "" "\" в нескольких местах раздела)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:194 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:193 msgid "" "To avoid possible DoS attacks and infinite loops, only 10 options on ND " "packet is accepted now. Therefore, if you have 20 prefix options attached " @@ -553,13 +553,13 @@ msgstr "" "высоком спросе мы можем предоставить sysctl-параметр для этой переменной." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:196 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:195 #, no-wrap msgid "Scope Index" msgstr "Индекс зоны" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:201 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:200 msgid "" "IPv6 uses scoped addresses. Therefore, it is very important to specify " "scope index (interface index for link-local address, or site index for site-" @@ -575,7 +575,7 @@ msgstr "" "пакета." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:206 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:205 msgid "" "Ordinary userland applications should use advanced API (RFC2292) to specify " "scope index, or interface index. For similar purpose, sin6_scope_id member " @@ -591,7 +591,7 @@ msgstr "" "вместо sin6_scope_id." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:209 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:208 msgid "" "In the kernel, an interface index for link-local scoped address is embedded " "into 2nd 16bit-word (3rd and 4th byte) in IPv6 address. For example, you " @@ -602,13 +602,13 @@ msgstr "" "Например, вы можете увидеть что-то вроде:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:213 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:212 #, no-wrap msgid "\tfe80:1::200:f8ff:fe01:6317\n" msgstr "\tfe80:1::200:f8ff:fe01:6317\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:218 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:217 msgid "" "in the routing table and interface address structure (struct in6_ifaddr). " "The address above is a link-local unicast address which belongs to a network " @@ -623,7 +623,7 @@ msgstr "" "нескольких интерфейсах с минимальными изменениями кода." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:223 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:222 msgid "" "Routing daemons and configuration programs, like man:route6d[8] and man:" "ifconfig[8], will need to manipulate the \"embedded\" scope index. These " @@ -640,7 +640,7 @@ msgstr "" "использующие эти API, в любом случае должны быть готовы к различиям в ядрах." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:230 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:229 msgid "" "When you specify scoped address to the command line, NEVER write the " "embedded form (such as ff02:1::1 or fe80:2::fedc). This is not supposed to " @@ -662,7 +662,7 @@ msgstr "" "Мы считаем, что спецификации нуждаются в некоторых улучшениях для этого." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:234 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:233 msgid "" "Some of the userland tools support extended numeric IPv6 syntax, as " "documented in [.filename]#draft-ietf-ipngwg-scopedaddr-format-00.txt#. You " @@ -677,7 +677,7 @@ msgstr "" "локальный адрес с ограниченной областью действия." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:237 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:236 msgid "" "To use this extension in your program, you will need to use man:" "getaddrinfo[3], and man:getnameinfo[3] with NI_WITHSCOPEID. The " @@ -691,13 +691,13 @@ msgstr "" "спецификациях." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:239 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:238 #, no-wrap msgid "Plug and Play" msgstr "Plug and Play (подключи и работай)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:245 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:244 msgid "" "Most of the IPv6 stateless address autoconfiguration is implemented in the " "kernel. Neighbor Discovery functions are implemented in the kernel as a " @@ -713,13 +713,13 @@ msgstr "" "пользовательском пространстве." #. type: Title ===== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:246 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:245 #, no-wrap msgid "Assignment of link-local, and special addresses" msgstr "Назначение линк-локальных и специальных адресов" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:251 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:250 msgid "" "IPv6 link-local address is generated from IEEE802 address (Ethernet MAC " "address). Each of interface is assigned an IPv6 link-local address " @@ -732,12 +732,12 @@ msgstr "" "добавляется прямой маршрут для линк-локального адреса." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:253 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:252 msgid "Here is an output of netstat command:" msgstr "Вот вывод команды netstat:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:260 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:259 #, no-wrap msgid "" "Internet6:\n" @@ -751,7 +751,7 @@ msgstr "" "fe80:2::%ep0/64 link#2 UC ep0\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:265 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:264 msgid "" "Interfaces that has no IEEE802 address (pseudo interfaces like tunnel " "interfaces, or ppp interfaces) will borrow IEEE802 address from other " @@ -763,13 +763,13 @@ msgstr "" "Интерфейсы, не имеющие адреса IEEE802 (псевдоинтерфейсы, такие как " "туннельные интерфейсы или интерфейсы ppp), будут заимствовать адрес IEEE802 " "у других интерфейсов, например, Ethernet-интерфейсов, когда это возможно. " -"Если нет подключенного оборудования IEEE802, в качестве последнего средства " +"Если нет подключённого оборудования IEEE802, в качестве последнего средства " "будет использовано псевдослучайное значение MD5(hostname) для формирования " "линк-локального адреса. Если это не подходит для вашего использования, вам " "потребуется настроить линк-локальный адрес вручную." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:268 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:267 msgid "" "If an interface is not capable of handling IPv6 (such as lack of multicast " "support), link-local address will not be assigned to that interface. See " @@ -780,7 +780,7 @@ msgstr "" "Подробности см. в разделе 2." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:272 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:271 msgid "" "Each interface joins the solicited multicast address and the link-local all-" "nodes multicast addresses (e.g., fe80::1:ff01:6317 and ff02::1, " @@ -799,13 +799,13 @@ msgstr "" "пределах узла ff01::1." #. type: Title ===== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:273 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:272 #, no-wrap msgid "Stateless address autoconfiguration on Hosts" msgstr "Автоматическая настройка адресов без состояния на узлах" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:277 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:276 msgid "" "In IPv6 specification, nodes are separated into two categories: _routers_ " "and _hosts_. Routers forward packets addressed to others, hosts does not " @@ -819,7 +819,7 @@ msgstr "" "1, хост, если 0)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:286 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:285 msgid "" "When a host hears Router Advertisement from the router, a host may " "autoconfigure itself by stateless address autoconfiguration. This behavior " @@ -851,7 +851,7 @@ msgstr "" "inet6.ip6.accept_rtadv в 0." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:288 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:287 msgid "" "To generate Router Advertisement from a router, use the man:rtadvd[8] daemon." msgstr "" @@ -859,7 +859,7 @@ msgstr "" "rtadvd[8]." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:290 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:289 msgid "" "Note that, IPv6 specification assumes the following items, and nonconforming " "cases are left unspecified:" @@ -868,17 +868,17 @@ msgstr "" "случаи несоответствия остаются неуточнёнными:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:292 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:291 msgid "Only hosts will listen to router advertisements" msgstr "Только хосты будут принимать объявления от маршрутизаторов" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:293 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:292 msgid "Hosts have single network interface (except loopback)" msgstr "Узлы имеют один сетевой интерфейс (за исключением loopback)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:296 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:295 msgid "" "Therefore, this is unwise to enable net.inet6.ip6.accept_rtadv on routers, " "or multi-interface host. A misconfigured node can behave strange " @@ -891,12 +891,12 @@ msgstr "" "провести эксперименты)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:298 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:297 msgid "To summarize the sysctl knob:" msgstr "Резюмируя настройку sysctl:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:312 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:311 #, no-wrap msgid "" "\taccept_rtadv\tforwarding\trole of the node\n" @@ -924,7 +924,7 @@ msgstr "" "\t\t\t\t\t(out-of-scope of spec)\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:317 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:316 msgid "" "RFC2462 has validation rule against incoming RA prefix information option, " "in 5.5.3 (e). This is to protect hosts from malicious (or misconfigured) " @@ -939,7 +939,7 @@ msgstr "" "6712)\" в архиве), и это обновление Джима реализовано." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:319 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:318 msgid "" "See crossref:ipv6[neighbor-discovery,Neighbor Discovery] in the document for " "relationship between DAD and autoconfiguration." @@ -948,13 +948,13 @@ msgstr "" "в этом документе для информации о взаимосвязи между DAD и автонастройкой." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:321 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:320 #, no-wrap msgid "Generic Tunnel Interface" msgstr "Универсальный туннельный интерфейс" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:325 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:324 msgid "" "GIF (Generic InterFace) is a pseudo interface for configured tunnel. " "Details are described in man:gif[4]. Currently" @@ -963,27 +963,27 @@ msgstr "" "Подробности описаны в man:gif[4]. В настоящее время" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:327 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:326 msgid "v6 in v6" msgstr "v6 в v6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:328 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:327 msgid "v6 in v4" msgstr "v6 в v4" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:329 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:328 msgid "v4 in v6" msgstr "v4 в v6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:330 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:329 msgid "v4 in v4" msgstr "v4 в v4" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:335 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:334 msgid "" "are available. Use man:gifconfig[8] to assign physical (outer) source and " "destination address to gif interfaces. Configuration that uses same address " @@ -999,7 +999,7 @@ msgstr "" "_Пожалуйста, будьте осторожны_." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:338 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:337 msgid "" "gif can be configured to be ECN-friendly. See crossref:ipv6[ipsec-ecn,ECN " "Consideration on IPsec Tunnels] for ECN-friendliness of tunnels, and man:" @@ -1010,7 +1010,7 @@ msgstr "" "IPsec-туннелях], а о настройке — в man:gif[4]." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:341 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:340 msgid "" "If you would like to configure an IPv4-in-IPv6 tunnel with gif interface, " "read man:gif[4] carefully. You will need to remove IPv6 link-local address " @@ -1021,13 +1021,13 @@ msgstr "" "автоматически назначенный интерфейсу gif." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:343 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:342 #, no-wrap msgid "Source Address Selection" msgstr "Выбор исходящего адреса" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:347 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:346 msgid "" "Current source selection rule is scope oriented (there are some exceptions - " "see below). For a given destination, a source IPv6 address is selected by " @@ -1038,7 +1038,7 @@ msgstr "" "выбирается по следующему правилу:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:349 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:348 msgid "" "If the source address is explicitly specified by the user (e.g., via the " "advanced API), the specified address is used." @@ -1047,7 +1047,7 @@ msgstr "" "API), используется указанный адрес." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:350 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:349 msgid "" "If there is an address assigned to the outgoing interface (which is usually " "determined by looking up the routing table) that has the same scope as the " @@ -1058,12 +1058,12 @@ msgstr "" "назначения, используется этот адрес." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:352 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:351 msgid "This is the most typical case." msgstr "Это наиболее типичный случай." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:353 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:352 msgid "" "If there is no address that satisfies the above condition, choose a global " "address assigned to one of the interfaces on the sending node." @@ -1072,7 +1072,7 @@ msgstr "" "глобальный адрес, назначенный одному из интерфейсов на отправляющем узле." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:354 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:353 msgid "" "If there is no address that satisfies the above condition, and destination " "address is site local scope, choose a site local address assigned to one of " @@ -1083,7 +1083,7 @@ msgstr "" "назначенный одному из интерфейсов на отправляющем узле." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:355 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:354 msgid "" "If there is no address that satisfies the above condition, choose the " "address associated with the routing table entry for the destination. This is " @@ -1094,7 +1094,7 @@ msgstr "" "которая может нарушить границы зоны действия." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:361 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:360 msgid "" "For instance, ::1 is selected for ff01::1, fe80:1::200:f8ff:fe01:6317 for " "fe80:1::2a0:24ff:feab:839b (note that embedded interface index - described " @@ -1112,13 +1112,13 @@ msgstr "" "помогает нам выбрать правильный исходный адрес. Эти встроенные индексы не " "будут передаваться по сети). Если исходящий интерфейс имеет несколько " "адресов для данной зоны, исходный адрес выбирается на основе наибольшего " -"соответствия (правило 3). Предположим, что 2001:0DB8:808:1:200:f8ff:fe01:" -"6317 и 2001:0DB8:9:124:200:f8ff:fe01:6317 назначены исходящему интерфейсу. " -"2001:0DB8:808:1:200:f8ff:fe01:6317 выбирается в качестве исходящего адреса " -"для адреса назначения 2001:0DB8:800::1." +"соответствия (правило 3). Предположим, что 2001:0DB8:808:1:200:f8ff:" +"fe01:6317 и 2001:0DB8:9:124:200:f8ff:fe01:6317 назначены исходящему " +"интерфейсу. 2001:0DB8:808:1:200:f8ff:fe01:6317 выбирается в качестве " +"исходящего адреса для адреса назначения 2001:0DB8:800::1." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:368 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:367 msgid "" "Note that the above rule is not documented in the IPv6 spec. It is " "considered \"up to implementation\" item. There are some cases where we do " @@ -1133,13 +1133,13 @@ msgstr "" "реализации\". Существуют случаи, когда мы не используем это правило. Один из " "примеров — установленное TCP-соединение, где мы используем адрес, " "сохранённый в tcb, в качестве источника. Другой пример — исходящий адрес для " -"Объявления Соседа (Neighbor Advertisement). Согласно спецификации (RFC2461 7." -"2.2) источник NA должен быть целевым адресом соответствующего NS. В этом " +"Объявления Соседа (Neighbor Advertisement). Согласно спецификации (RFC2461 " +"7.2.2) источник NA должен быть целевым адресом соответствующего NS. В этом " "случае мы следуем спецификации, а не приведённому выше правилу наибольшего " "совпадения." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:374 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:373 msgid "" "For new connections (when rule 1 does not apply), deprecated addresses " "(addresses with preferred lifetime = 0) will not be chosen as source address " @@ -1164,13 +1164,13 @@ msgstr "" "ведутся дебаты о том, как использовать \"устаревшие\" адреса)." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:376 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:375 #, no-wrap msgid "Jumbo Payload" msgstr "Джамбо-пакет (Jumbo Payload)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:380 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:379 msgid "" "The Jumbo Payload hop-by-hop option is implemented and can be used to send " "IPv6 packets with payloads longer than 65,535 octets. But currently no " @@ -1184,7 +1184,7 @@ msgstr "" "интерфейсе loopback (т.е. lo0)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:382 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:381 msgid "" "If you want to try jumbo payloads, you first have to reconfigure the kernel " "so that the MTU of the loopback interface is more than 65,535 bytes; add the " @@ -1195,17 +1195,17 @@ msgstr "" "байт; добавьте следующее в конфигурационный файл ядра:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:384 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:383 msgid "`options \"LARGE_LOMTU\" #To test jumbo payload`" msgstr "`options \"LARGE_LOMTU\" #To test jumbo payload`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:386 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:385 msgid "and recompile the new kernel." msgstr "и пересоберите новое ядро." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:390 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:389 msgid "" "Then you can test jumbo payloads by the man:ping[8] command with -6, -b and -" "s options. The -b option must be specified to enlarge the size of the " @@ -1218,13 +1218,13 @@ msgstr "" "535. Например, введите следующее:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:394 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:393 #, no-wrap msgid "% ping -6 -b 70000 -s 68000 ::1\n" msgstr "% ping -6 -b 70000 -s 68000 ::1\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:399 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:398 msgid "" "The IPv6 specification requires that the Jumbo Payload option must not be " "used in a packet that carries a fragment header. If this condition is " @@ -1239,7 +1239,7 @@ msgstr "" "требованием." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:403 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:402 msgid "" "When an IPv6 packet is received, the frame length is checked and compared to " "the length specified in the payload length field of the IPv6 header or in " @@ -1255,7 +1255,7 @@ msgstr "" "выводе команды man:netstat[8] с опцией `-s -p ip6`:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:410 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:409 #, no-wrap msgid "" "% netstat -s -p ip6\n" @@ -1269,7 +1269,7 @@ msgstr "" "\t\t1 with data size < data length\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:414 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:413 msgid "" "So, kernel does not send an ICMPv6 error unless the erroneous packet is an " "actual Jumbo Payload, that is, its packet size is more than 65,535 bytes. " @@ -1282,7 +1282,7 @@ msgstr "" "с таким огромным MTU, поэтому ICMPv6 ошибка возвращается редко." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:417 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:416 msgid "" "TCP/UDP over jumbogram is not supported at this moment. This is because we " "have no medium (other than loopback) to test this. Contact us if you need " @@ -1293,7 +1293,7 @@ msgstr "" "функциональности. Свяжитесь с нами, если вам это необходимо." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:420 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:419 msgid "" "IPsec does not work on jumbograms. This is due to some specification twists " "in supporting AH with jumbograms (AH header size influences payload length, " @@ -1306,7 +1306,7 @@ msgstr "" "пакета с опцией Джамбо-пакет, а также AH)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:424 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:423 msgid "" "There are fundamental issues in *BSD support for jumbograms. We would like " "to address those, but we need more time to finalize these. To name a few:" @@ -1316,7 +1316,7 @@ msgstr "" "некоторые из них:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:428 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:427 msgid "" "mbuf pkthdr.len field is typed as \"int\" in 4.4BSD, so it will not hold " "jumbogram with len > 2G on 32bit architecture CPUs. If we would like to " @@ -1332,7 +1332,7 @@ msgstr "" "(`u_int32_t` НЕ достаточно)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:430 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:429 msgid "" "We mistakingly use \"int\" to hold packet length in many places. We need to " "convert them into larger integral type. It needs a great care, as we may " @@ -1344,7 +1344,7 @@ msgstr "" "во время вычисления длины пакета." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:431 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:430 msgid "" "We mistakingly check for ip6_plen field of IPv6 header for packet payload " "length in various places. We should be checking mbuf pkthdr.len instead. " @@ -1358,18 +1358,18 @@ msgstr "" "pkthdr.len." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:432 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:431 msgid "TCP code needs a careful update in bunch of places, of course." msgstr "Код TCP требует тщательного обновления в ряде мест, разумеется." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:433 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:432 #, no-wrap msgid "Loop Prevention in Header Processing" msgstr "Предотвращение петель при обработке заголовков" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:444 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:443 msgid "" "IPv6 specification allows arbitrary number of extension headers to be placed " "onto packets. If we implement IPv6 packet processing code in the way BSD " @@ -1401,13 +1401,13 @@ msgstr "" "анонимный злоумышленник не сможет осуществить подобную атаку.)" #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:446 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:445 #, no-wrap msgid "ICMPv6" msgstr "ICMPv6" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:450 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:449 msgid "" "After RFC2463 was published, IETF ipngwg has decided to disallow ICMPv6 " "error packet against ICMPv6 redirect, to prevent ICMPv6 storm on a network " @@ -1418,13 +1418,13 @@ msgstr "" "среде. Это уже реализовано в ядре." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:451 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:450 #, no-wrap msgid "Applications" msgstr "Приложения (Applications)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:454 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:453 msgid "" "For userland programming, we support IPv6 socket API as specified in " "RFC2553, RFC2292 and upcoming Internet drafts." @@ -1434,7 +1434,7 @@ msgstr "" "черновиках." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:459 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:458 msgid "" "TCP/UDP over IPv6 is available and quite stable. You can enjoy man:" "telnet[1], man:ftp[1], man:rlogin[1], man:rsh[1], man:ssh[1], etc. These " @@ -1447,13 +1447,13 @@ msgstr "" "или IPv6 в соответствии с DNS." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:460 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:459 #, no-wrap msgid "Kernel Internals" msgstr "Внутреннее устройство ядра" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:463 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:462 msgid "" "While ip_forward() calls ip_output(), ip6_forward() directly calls " "if_output() since routers must not divide IPv6 packets into fragments." @@ -1463,7 +1463,7 @@ msgstr "" "IPv6 на фрагменты." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:467 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:466 msgid "" "ICMPv6 should contain the original packet as long as possible up to 1280. " "UDP6/IP6 port unreach, for instance, should contain all extension headers " @@ -1478,7 +1478,7 @@ msgstr "" "сети в порядок байтов хоста, чтобы сохранить исходный пакет." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:471 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:470 msgid "" "tcp_input(), udp6_input() and icmp6_input() can not assume that IP6 header " "is preceding the transport headers due to extension headers. So, " @@ -1494,7 +1494,7 @@ msgstr "" "контрольной суммы." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:474 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:473 msgid "" "To process IP6 header, extension headers and transport headers easily, " "network drivers are now required to store packets in one internal mbuf or " @@ -1510,7 +1510,7 @@ msgstr "" "внешнем mbuf." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:478 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:477 msgid "" "`netstat -s -p ip6` tells you whether or not your driver conforms such " "requirement. In the following example, \"cce0\" violates the requirement. " @@ -1521,7 +1521,7 @@ msgstr "" "получения дополнительной информации обратитесь к разделу 2.)" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:488 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:487 #, no-wrap msgid "" "Mbuf statistics:\n" @@ -1541,7 +1541,7 @@ msgstr "" " 0 two or more ext mbuf\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:493 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:492 msgid "" "Each input function calls IP6_EXTHDR_CHECK in the beginning to check if the " "region between IP6 and its header is continuous. IP6_EXTHDR_CHECK calls " @@ -1556,19 +1556,19 @@ msgstr "" "приходящих с физических сетевых интерфейсов." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:495 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:494 msgid "Both IP and IP6 reassemble functions never call m_pullup()." msgstr "" "Как функции повторной сборки IP, так и IP6 никогда не вызывают m_pullup()." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:497 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:496 #, no-wrap msgid "IPv4 Mapped Address and IPv6 Wildcard Socket" msgstr "IPv4-отображённые адреса и IPv6-сокет с подстановочным адресом" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:501 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:500 msgid "" "RFC2553 describes IPv4 mapped address (3.7) and special behavior of IPv6 " "wildcard bind socket (3.8). The spec allows you to:" @@ -1577,14 +1577,14 @@ msgstr "" "сокета с привязкой к любому адресу (3.8). Спецификация позволяет вам:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:503 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:502 msgid "Accept IPv4 connections by AF_INET6 wildcard bind socket." msgstr "" "Принимать IPv4-подключения через сокет с привязкой к подстановочному адресу " "AF_INET6." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:504 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:503 msgid "" "Transmit IPv4 packet over AF_INET6 socket by using special form of the " "address like ::ffff:10.1.1.1." @@ -1593,7 +1593,7 @@ msgstr "" "адреса, например ::ffff:10.1.1.1." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:507 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:506 msgid "" "but the spec itself is very complicated and does not specify how the socket " "layer should behave. Here we call the former one \"listening side\" and the " @@ -1604,7 +1604,7 @@ msgstr "" "«инициирующей» для удобства ссылок." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:509 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:508 msgid "" "You can perform wildcard bind on both of the address families, on the same " "port." @@ -1613,12 +1613,12 @@ msgstr "" "адресов на одном и том же порту." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:511 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:510 msgid "The following table show the behavior of FreeBSD 4.x." msgstr "Следующая таблица показывает поведение FreeBSD 4.x." #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:520 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:519 #, no-wrap msgid "" "listening side initiating side\n" @@ -1636,7 +1636,7 @@ msgstr "" " default: enabled\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:523 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:522 msgid "" "The following sections will give you more details, and how you can configure " "the behavior." @@ -1645,12 +1645,12 @@ msgstr "" "можно настроить поведение." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:525 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:524 msgid "Comments on listening side:" msgstr "Комментарии о принимающей стороне:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:532 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:531 msgid "" "It looks that RFC2553 talks too little on wildcard bind issue, especially on " "the port space issue, failure mode and relationship between AF_INET/INET6 " @@ -1667,15 +1667,15 @@ msgstr "" "отказа и взаимосвязи между AF_INET/INET6 wildcard bind. Может быть " "несколько различных интерпретаций этого RFC, которые соответствуют ему, но " "ведут себя по-разному. Поэтому для создания переносимых приложений не " -"следует делать никаких предположений о поведении в ядре. Использование " -"man:getaddrinfo[3] является наиболее безопасным способом. Вопросы " -"пространства номеров портов и привязки к подстановочному адресу подробно " -"обсуждались в рассылке ipv6imp в середине марта 1999 года, и похоже, что " -"конкретного консенсуса нет (то есть, остаётся на усмотрение реализаторов). " -"Возможно, вам стоит проверить архивы рассылки." +"следует делать никаких предположений о поведении в ядре. Использование man:" +"getaddrinfo[3] является наиболее безопасным способом. Вопросы пространства " +"номеров портов и привязки к подстановочному адресу подробно обсуждались в " +"рассылке ipv6imp в середине марта 1999 года, и похоже, что конкретного " +"консенсуса нет (то есть, остаётся на усмотрение реализаторов). Возможно, " +"вам стоит проверить архивы рассылки." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:534 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:533 msgid "" "If a server application would like to accept IPv4 and IPv6 connections, " "there will be two alternatives." @@ -1684,7 +1684,7 @@ msgstr "" "варианта." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:539 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:538 msgid "" "One is using AF_INET and AF_INET6 socket (you will need two sockets). Use " "man:getaddrinfo[3] with AI_PASSIVE into ai_flags, and man:socket[2] and man:" @@ -1701,7 +1701,7 @@ msgstr "" "— сокетом AF_INET6." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:545 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:544 msgid "" "Another way is using one AF_INET6 wildcard bind socket. Use man:" "getaddrinfo[3] with AI_PASSIVE into ai_flags and with AF_INET6 into " @@ -1717,7 +1717,7 @@ msgstr "" "пакеты как IPv4, так и IPv6." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:549 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:548 msgid "" "To support only IPv6 traffic on AF_INET6 wildcard binded socket portably, " "always check the peer address when a connection is made toward AF_INET6 " @@ -1732,7 +1732,7 @@ msgstr "" "проверить с помощью макроса IN6_IS_ADDR_V4MAPPED()." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:551 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:550 msgid "" "To resolve this issue more easily, there is system dependent man:" "setsockopt[2] option, IPV6_BINDV6ONLY, used like below." @@ -1742,15 +1742,15 @@ msgstr "" "следующим образом." #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:555 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:602 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:554 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:601 #, no-wrap msgid "\tint on;\n" msgstr "\tint on;\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:558 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:605 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:557 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:604 #, no-wrap msgid "" "\tsetsockopt(s, IPPROTO_IPV6, IPV6_BINDV6ONLY,\n" @@ -1760,17 +1760,17 @@ msgstr "" "\t\t (char *)&on, sizeof (on)) < 0));\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:561 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:560 msgid "When this call succeed, then this socket only receive IPv6 packets." msgstr "При успешном вызове этот сокет будет принимать только IPv6-пакеты." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:563 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:562 msgid "Comments on initiating side:" msgstr "Комментарии о стороне инициатора:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:565 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:564 msgid "" "Advise to application implementers: to implement a portable IPv6 application " "(which works on multiple IPv6 kernels), we believe that the following is the " @@ -1781,12 +1781,12 @@ msgstr "" "моменты являются ключом к успеху:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:567 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:566 msgid "NEVER hardcode AF_INET nor AF_INET6." msgstr "НИКОГДА не используйте жёстко заданные AF_INET или AF_INET6." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:568 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:567 msgid "" "Use man:getaddrinfo[3] and man:getnameinfo[3] throughout the system. Never " "use gethostby*(), getaddrby*(), inet_*() or getipnodeby*(). (To update " @@ -1801,7 +1801,7 @@ msgstr "" "код для использования man:getaddrinfo[3] и man:getnameinfo[3].)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:569 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:568 msgid "" "If you would like to connect to destination, use man:getaddrinfo[3] and try " "all the destination returned, like man:telnet[1] does." @@ -1810,7 +1810,7 @@ msgstr "" "попробуйте все возвращённые назначения, как это делает man:telnet[1]." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:570 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:569 msgid "" "Some of the IPv6 stack is shipped with buggy man:getaddrinfo[3]. Ship a " "minimal working version with your application and use that as last resort." @@ -1820,7 +1820,7 @@ msgstr "" "используйте её в крайнем случае." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:576 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:575 msgid "" "If you would like to use AF_INET6 socket for both IPv4 and IPv6 outgoing " "connection, you will need to use man:getipnodebyname[3]. When you would " @@ -1842,7 +1842,7 @@ msgstr "" "будет время это сделать." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:580 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:579 msgid "" "When writing applications that make outgoing connections, story goes much " "simpler if you treat AF_INET and AF_INET6 as totally separate address " @@ -1856,13 +1856,13 @@ msgstr "" "на IPv4-отображённые адреса." #. type: Title ===== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:581 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:580 #, no-wrap msgid "unified tcp and inpcb code" msgstr "унифицированный код tcp и inpcb" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:585 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:584 msgid "" "FreeBSD 4.x uses shared tcp code between IPv4 and IPv6 (from sys/netinet/" "tcp*) and separate udp4/6 code. It uses unified inpcb structure." @@ -1871,7 +1871,7 @@ msgstr "" "раздельный код udp4/6. В нём используется унифицированная структура inpcb." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:588 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:587 msgid "" "The platform can be configured to support IPv4 mapped address. Kernel " "configuration is summarized as follows:" @@ -1880,7 +1880,7 @@ msgstr "" "Конфигурация ядра кратко описана ниже:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:590 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:589 msgid "" "By default, AF_INET6 socket will grab IPv4 connections in certain condition, " "and can initiate connection to IPv4 destination embedded in IPv4 mapped IPv6 " @@ -1891,23 +1891,23 @@ msgstr "" "отображённые IPv6-адреса." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:591 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:590 msgid "You can disable it on entire system with sysctl like below." msgstr "" "Вы можете отключить это во всей системе с помощью sysctl, как показано ниже." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:593 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:592 msgid "`sysctl net.inet6.ip6.mapped_addr=0`" msgstr "`sysctl net.inet6.ip6.mapped_addr=0`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:595 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:594 msgid "====== Listening Side" msgstr "====== Сторона, принимающая соединения" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:598 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:597 msgid "" "Each socket can be configured to support special AF_INET6 wildcard bind " "(enabled by default). You can disable it on each socket basis with man:" @@ -1918,7 +1918,7 @@ msgstr "" "для каждого отдельного сокета с помощью man:setsockopt[2], как показано ниже." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:608 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:607 msgid "" "Wildcard AF_INET6 socket grabs IPv4 connection if and only if the following " "conditions are satisfied:" @@ -1927,12 +1927,12 @@ msgstr "" "тогда и только тогда, когда выполнены следующие условия:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:610 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:609 msgid "there is no AF_INET socket that matches the IPv4 connection" msgstr "нет AF_INET сокета, соответствующего IPv4-подключению" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:611 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:610 msgid "" "the AF_INET6 socket is configured to accept IPv4 traffic, i.e., " "getsockopt(IPV6_BINDV6ONLY) returns 0." @@ -1941,17 +1941,17 @@ msgstr "" "getsockopt(IPV6_BINDV6ONLY) возвращает 0." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:613 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:612 msgid "There is no problem with open/close ordering." msgstr "Нет проблем с порядком открытия/закрытия." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:615 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:614 msgid "====== Initiating Side" msgstr "====== Инициирующая сторона" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:617 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:616 msgid "" "FreeBSD 4.x supports outgoing connection to IPv4 mapped address (::" "ffff:10.1.1.1), if the node is configured to support IPv4 mapped address." @@ -1960,13 +1960,13 @@ msgstr "" "ffff:10.1.1.1), если узел настроен на поддержку IPv4-отображённых адресов." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:618 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:617 #, no-wrap msgid "sockaddr_storage" msgstr "sockaddr_storage" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:624 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:623 msgid "" "When RFC2553 was about to be finalized, there was discussion on how struct " "sockaddr_storage members are named. One proposal is to prepend \"__\" to " @@ -1979,17 +1979,17 @@ msgstr "" "добавлении \"__\" перед именами элементов (например, \"__ss_len\"), так как " "к ним не следует обращаться напрямую. Другое предложение было не добавлять " "префикс (например, \"ss_len\"), поскольку необходимо прямое обращение к этим " -"элементам. Четкого консенсуса по этому вопросу достигнуто не было." +"элементам. Чёткого консенсуса по этому вопросу достигнуто не было." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:626 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:625 msgid "As a result, RFC2553 defines struct sockaddr_storage as follows:" msgstr "" "В результате, RFC2553 определяет структуру sockaddr_storage следующим " "образом:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:634 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:633 #, no-wrap msgid "" "\tstruct sockaddr_storage {\n" @@ -2005,12 +2005,12 @@ msgstr "" "\t};\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:637 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:636 msgid "On the contrary, XNET draft defines as follows:" msgstr "Напротив, черновик XNET определяет следующее:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:645 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:644 #, no-wrap msgid "" "\tstruct sockaddr_storage {\n" @@ -2026,7 +2026,7 @@ msgstr "" "\t};\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:648 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:647 msgid "" "In December 1999, it was agreed that RFC2553bis should pick the latter " "(XNET) definition." @@ -2035,7 +2035,7 @@ msgstr "" "последнее (XNET) определение." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:650 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:649 msgid "" "Current implementation conforms to XNET definition, based on RFC2553bis " "discussion." @@ -2044,7 +2044,7 @@ msgstr "" "RFC2553bis." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:653 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:652 msgid "" "If you look at multiple IPv6 implementations, you will be able to see both " "definitions. As an userland programmer, the most portable way of dealing " @@ -2055,7 +2055,7 @@ msgstr "" "переносимый способ работы с этим:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:655 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:654 msgid "" "ensure ss_family and/or ss_len are available on the platform, by using GNU " "autoconf," @@ -2064,7 +2064,7 @@ msgstr "" "на целевой платформе," #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:656 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:655 msgid "" "have -Dss_family=__ss_family to unify all occurrences (including header " "file) into __ss_family, or" @@ -2073,14 +2073,14 @@ msgstr "" "заголовочный файл) __ss_family, или" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:657 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:656 msgid "never touch __ss_family. cast to sockaddr * and use sa_family like:" msgstr "" "никогда не трогайте __ss_family. Приводите к sockaddr * и используйте " "sa_family, например:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:662 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:661 #, no-wrap msgid "" "\tstruct sockaddr_storage ss;\n" @@ -2090,13 +2090,13 @@ msgstr "" "\tfamily = ((struct sockaddr *)&ss)->sa_family\n" #. type: Title === -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:664 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:663 #, no-wrap msgid "Network Drivers" msgstr "Драйверы сетевых устройств" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:667 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:666 msgid "" "Now following two items are required to be supported by standard drivers:" msgstr "" @@ -2104,7 +2104,7 @@ msgstr "" "драйверами:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:669 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:668 msgid "" "mbuf clustering requirement. In this stable release, we changed MINCLSIZE " "into MHLEN+1 for all the operating systems in order to make all the drivers " @@ -2115,7 +2115,7 @@ msgstr "" "работали так, как мы ожидаем." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:670 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:669 msgid "" "multicast. If man:ifmcstat[8] yields no multicast group for a interface, " "that interface has to be patched." @@ -2124,7 +2124,7 @@ msgstr "" "многоадресной группы для интерфейса, этот интерфейс необходимо исправить." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:673 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:672 msgid "" "If any of the drivers do not support the requirements, then the drivers " "cannot be used for IPv6 and/or IPsec communication. If you find any problem " @@ -2137,7 +2137,7 @@ msgstr "" "bugs}." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:676 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:675 msgid "" "(NOTE: In the past we required all PCMCIA drivers to have a call to " "in6_ifattach(). We have no such requirement any more)" @@ -2146,18 +2146,18 @@ msgstr "" "in6_ifattach(). Теперь такого требования нет)" #. type: Title === -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:677 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:676 #, no-wrap msgid "Translator" msgstr "Транслятор" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:680 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:679 msgid "We categorize IPv4/IPv6 translator into 4 types:" msgstr "Мы классифицируем трансляторы IPv4/IPv6 на 4 типа:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:682 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:681 msgid "" "_Translator A_ --- It is used in the early stage of transition to make it " "possible to establish a connection from an IPv6 host in an IPv6 island to an " @@ -2168,7 +2168,7 @@ msgstr "" "океане." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:683 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:682 msgid "" "_Translator B_ --- It is used in the early stage of transition to make it " "possible to establish a connection from an IPv4 host in the IPv4 ocean to an " @@ -2179,7 +2179,7 @@ msgstr "" "от IPv4-узла в IPv4-океане." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:684 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:683 msgid "" "_Translator C_ --- It is used in the late stage of transition to make it " "possible to establish a connection from an IPv4 host in an IPv4 island to an " @@ -2190,7 +2190,7 @@ msgstr "" "IPv4-острове." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:685 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:684 msgid "" "_Translator D_ --- It is used in the late stage of transition to make it " "possible to establish a connection from an IPv6 host in the IPv6 ocean to an " @@ -2201,37 +2201,37 @@ msgstr "" "IPv4-острове." #. type: Title === -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:687 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:686 #, no-wrap msgid "IPsec" msgstr "IPsec" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:690 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:689 msgid "IPsec is mainly organized by three components." msgstr "IPsec состоит в основном из трёх компонент." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:692 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:695 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:691 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:694 #, no-wrap msgid "Policy Management" msgstr "Управление политиками" #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:693 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:705 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:692 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:704 #, no-wrap msgid "Key Management" msgstr "Управление ключами" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:694 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:693 msgid "AH and ESP handling" msgstr "Обработка AH и ESP" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:702 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:701 msgid "" "The kernel implements experimental policy management code. There are two " "way to manage security policy. One is to configure per-socket policy using " @@ -2247,7 +2247,7 @@ msgstr "" "интерфейса PF_KEY через man:setkey[8]." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:704 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:703 msgid "" "The policy entry is not re-ordered with its indexes, so the order of entry " "when you add is very significant." @@ -2256,7 +2256,7 @@ msgstr "" "порядок добавления записей очень важен." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:709 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:708 msgid "" "The key management code implemented in this kit (sys/netkey) is a home-brew " "PFKEY v2 implementation. This conforms to RFC2367." @@ -2266,7 +2266,7 @@ msgstr "" "RFC2367." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:713 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:712 msgid "" "The home-brew IKE daemon, \"racoon\" is included in the kit (kame/kame/" "racoon). Basically you will need to run racoon as daemon, then set up a " @@ -2280,13 +2280,13 @@ msgstr "" "необходимости для обмена ключами." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:714 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:713 #, no-wrap msgid "AH and ESP Handling" msgstr "Обработка AH и ESP" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:722 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:721 msgid "" "IPsec module is implemented as \"hooks\" to the standard IPv4/IPv6 " "processing. When sending a packet, ip{,6}_output() checks if ESP/AH " @@ -2312,7 +2312,7 @@ msgstr "" "\"сыром\" виде." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:725 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:724 msgid "" "By using ESP/AH, TCP4/6 effective data segment size will be affected by " "extra daisy-chained headers inserted by ESP/AH. Our code takes care of the " @@ -2323,7 +2323,7 @@ msgstr "" "учитывает этот случай." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:729 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:728 msgid "" "Basic crypto functions can be found in directory \"sys/crypto\". ESP/AH " "transform are listed in {esp,ah}_core.c with wrapper functions. If you wish " @@ -2337,7 +2337,7 @@ msgstr "" "алгоритма в `sys/crypto`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:731 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:730 msgid "" "Tunnel mode is partially supported in this release, with the following " "restrictions:" @@ -2346,7 +2346,7 @@ msgstr "" "ограничениями:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:733 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:732 msgid "" "IPsec tunnel is not combined with GIF generic tunneling interface. It needs " "a great care because we may create an infinite loop between ip_output() and " @@ -2358,7 +2358,7 @@ msgstr "" "того, лучше ли их объединить или нет." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:734 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:733 msgid "" "MTU and Don't Fragment bit (IPv4) considerations need more checking, but " "basically works fine." @@ -2367,7 +2367,7 @@ msgstr "" "основном работают нормально." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:735 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:734 msgid "" "Authentication model for AH tunnel must be revisited. We will need to " "improve the policy management engine, eventually." @@ -2376,13 +2376,13 @@ msgstr "" "потребуется улучшить механизм управления политиками в конечном итоге." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:736 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:735 #, no-wrap msgid "Conformance to RFCs and IDs" msgstr "Соответствие RFC и ID" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:739 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:738 msgid "" "The IPsec code in the kernel conforms (or, tries to conform) to the " "following standards:" @@ -2391,13 +2391,13 @@ msgstr "" "стандартам:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:741 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:740 msgid "\"old IPsec\" specification documented in [.filename]#rfc182[5-9].txt#" msgstr "" "Спецификация \"старого IPsec\", описанная в [.filename]#rfc182[5-9].txt#" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:744 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:743 msgid "" "\"new IPsec\" specification documented in [.filename]#rfc240[1-6].txt#, [." "filename]#rfc241[01].txt#, [.filename]#rfc2451.txt# and [.filename]#draft-" @@ -2415,112 +2415,112 @@ msgstr "" "\")" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:746 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:745 msgid "Currently supported algorithms are:" msgstr "В настоящее время поддерживаются следующие алгоритмы:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:748 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:785 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:747 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:784 msgid "old IPsec AH" msgstr "old IPsec AH" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:750 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:763 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:749 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:762 msgid "null crypto checksum (no document, just for debugging)" msgstr "" "нулевая криптографическая контрольная сумма (нет документа, только для " "отладки)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:751 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:750 msgid "keyed MD5 with 128bit crypto checksum ([.filename]#rfc1828.txt#)" msgstr "" "MD5 с ключом и с 128-битной криптографической контрольной суммой ([." "filename]#rfc1828.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:752 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:751 msgid "keyed SHA1 with 128bit crypto checksum (no document)" msgstr "" "SHA1 с ключом и с 128-битной криптографической контрольной суммой (без " "документа)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:753 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:752 msgid "HMAC MD5 with 128bit crypto checksum ([.filename]#rfc2085.txt#)" msgstr "" "HMAC MD5 с 128-битной криптографической контрольной суммой ([." "filename]#rfc2085.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:754 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:753 msgid "HMAC SHA1 with 128bit crypto checksum (no document)" msgstr "" "HMAC SHA1 с 128-битной криптографической контрольной суммой (без документа)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:756 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:755 msgid "old IPsec ESP" msgstr "old IPsec ESP" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:758 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:757 msgid "null encryption (no document, similar to [.filename]#rfc2410.txt#)" msgstr "" "нулевое шифрование (нет документа, аналогично [.filename]#rfc2410.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:759 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:758 msgid "DES-CBC mode ([.filename]#rfc1829.txt#)" msgstr "Режим DES-CBC ([.filename]#rfc1829.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:761 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:760 msgid "new IPsec AH" msgstr "new IPsec AH" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:764 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:763 msgid "keyed MD5 with 96bit crypto checksum (no document)" msgstr "" "MD5 с ключом и с 96-битной криптографической контрольной суммой (нет " "документа)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:765 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:764 msgid "keyed SHA1 with 96bit crypto checksum (no document)" msgstr "" "SHA1 с ключом и с 96-битной криптографической контрольной суммой (без " "документа)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:766 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:765 msgid "HMAC MD5 with 96bit crypto checksum ([.filename]#rfc2403.txt#)" msgstr "" "HMAC MD5 с 96-битной криптографической контрольной суммой ([." "filename]#rfc2403.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:767 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:766 msgid "HMAC SHA1 with 96bit crypto checksum ([.filename]#rfc2404.txt#)" msgstr "" "HMAC SHA1 с 96-битной криптографической контрольной суммой ([." "filename]#rfc2404.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:769 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:768 msgid "new IPsec ESP" msgstr "new IPsec ESP" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:771 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:770 msgid "null encryption ([.filename]#rfc2410.txt#)" msgstr "нулевое шифрование ([.filename]#rfc2410.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:772 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:771 msgid "" "DES-CBC with derived IV ([.filename]#draft-ietf-ipsec-ciph-des-derived-01." "txt#, draft expired)" @@ -2529,52 +2529,52 @@ msgstr "" "txt#, черновик истек)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:773 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:772 msgid "DES-CBC with explicit IV ([.filename]#rfc2405.txt#)" msgstr "DES-CBC с явным вектором инициализации ([.filename]#rfc2405.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:774 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:773 msgid "3DES-CBC with explicit IV ([.filename]#rfc2451.txt#)" msgstr "3DES-CBC с явным вектором инициализации ([.filename]#rfc2451.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:775 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:774 msgid "BLOWFISH CBC ([.filename]#rfc2451.txt#)" msgstr "BLOWFISH CBC ([.filename]#rfc2451.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:776 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:775 msgid "CAST128 CBC ([.filename]#rfc2451.txt#)" msgstr "CAST128 CBC ([.filename]#rfc2451.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:777 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:776 msgid "RC5 CBC ([.filename]#rfc2451.txt#)" msgstr "RC5 CBC ([.filename]#rfc2451.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:778 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:777 msgid "each of the above can be combined with:" msgstr "каждый из вышеперечисленных может быть объединён с:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:780 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:779 msgid "ESP authentication with HMAC-MD5(96bit)" msgstr "Аутентификация ESP с HMAC-MD5 (96 бит)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:781 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:780 msgid "ESP authentication with HMAC-SHA1(96bit)" msgstr "Аутентификация ESP с HMAC-SHA1(96 бит)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:783 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:782 msgid "The following algorithms are NOT supported:" msgstr "Следующие алгоритмы НЕ поддерживаются:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:787 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:786 msgid "" "HMAC MD5 with 128bit crypto checksum + 64bit replay prevention ([." "filename]#rfc2085.txt#)" @@ -2583,7 +2583,7 @@ msgstr "" "защита от повторного воспроизведения ([.filename]#rfc2085.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:788 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:787 msgid "" "keyed SHA1 with 160bit crypto checksum + 32bit padding ([.filename]#rfc1852." "txt#)" @@ -2592,7 +2592,7 @@ msgstr "" "битное дополнение ([.filename]#rfc1852.txt#)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:791 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:790 msgid "" "IPsec (in kernel) and IKE (in userland as \"racoon\") has been tested at " "several interoperability test events, and it is known to interoperate with " @@ -2608,13 +2608,13 @@ msgstr "" "алгоритмы без проблем с интеллектуальной собственностью)." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:793 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:792 #, no-wrap msgid "ECN Consideration on IPsec Tunnels" msgstr "Учёт ECN в IPsec-туннелях" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:796 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:795 msgid "" "ECN-friendly IPsec tunnel is supported as described in [.filename]#draft-" "ipsec-ecn-00.txt#." @@ -2623,7 +2623,7 @@ msgstr "" "filename]#draft-ipsec-ecn-00.txt#." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:801 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:800 msgid "" "Normal IPsec tunnel is described in RFC2401. On encapsulation, IPv4 TOS " "field (or, IPv6 traffic class field) will be copied from inner IP header to " @@ -2638,7 +2638,7 @@ msgstr "" "трафика внешнего IP-заголовка будет потерян." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:804 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:803 msgid "" "To make IPsec tunnel ECN-friendly, we should modify encapsulation and " "decapsulation procedure. This is described in http://www.aciri.org/floyd/" @@ -2651,7 +2651,7 @@ msgstr "" "txt], глава 3." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:806 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:805 msgid "" "IPsec tunnel implementation can give you three behaviors, by setting net." "inet.ipsec.ecn (or net.inet6.ipsec6.ecn) to some value:" @@ -2661,22 +2661,22 @@ msgstr "" "ipsec6.ecn`):" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:808 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:807 msgid "RFC2401: no consideration for ECN (sysctl value -1)" msgstr "RFC2401: отсутствие учёта ECN (значение sysctl -1)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:809 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:808 msgid "ECN forbidden (sysctl value 0)" msgstr "ECN запрещён (значение sysctl 0)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:810 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:809 msgid "ECN allowed (sysctl value 1)" msgstr "ECN разрешён (значение sysctl 1)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:812 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:811 msgid "" "Note that the behavior is configurable in per-node manner, not per-SA manner " "(draft-ipsec-ecn-00 wants per-SA configuration, but it looks too much for " @@ -2687,14 +2687,14 @@ msgstr "" "кажется излишним)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:814 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:813 msgid "" "The behavior is summarized as follows (see source code for more detail):" msgstr "" "Поведение можно обобщить следующим образом (подробности см. в исходном коде):" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:821 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:820 #, no-wrap msgid "" "encapsulate decapsulate\n" @@ -2708,7 +2708,7 @@ msgstr "" " from inner to outer. (use inner TOS bits as is)\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:825 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:824 #, no-wrap msgid "" "ECN forbidden copy TOS bits except for ECN drop TOS bits on outer\n" @@ -2720,7 +2720,7 @@ msgstr "" " to outer. set ECN bits to 0.\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:830 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:829 #, no-wrap msgid "" "ECN allowed copy TOS bits except for ECN use inner TOS bits with some\n" @@ -2734,12 +2734,12 @@ msgstr "" " set ECN CE bit to 0. the inner.\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:833 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:832 msgid "General strategy for configuration is as follows:" msgstr "Общая стратегия настройки выглядит следующим образом:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:835 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:834 msgid "" "if both IPsec tunnel endpoint are capable of ECN-friendly behavior, you " "should better configure both end to \"ECN allowed\" (sysctl value 1)." @@ -2748,7 +2748,7 @@ msgstr "" "к ECN, лучше настроить оба конца на \"разрешено ECN\" (значение sysctl 1)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:836 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:835 msgid "" "if the other end is very strict about TOS bit, use \"RFC2401\" (sysctl value " "-1)." @@ -2757,22 +2757,22 @@ msgstr "" "\"RFC2401\" (значение sysctl -1)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:837 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:836 msgid "in other cases, use \"ECN forbidden\" (sysctl value 0)." msgstr "в остальных случаях используйте \"ECN запрещено\" (значение sysctl 0)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:839 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:838 msgid "The default behavior is \"ECN forbidden\" (sysctl value 0)." msgstr "Поведение по умолчанию — \"ECN запрещён\" (значение sysctl 0)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:841 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:840 msgid "For more information, please refer to:" msgstr "Для получения дополнительной информации обратитесь к:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:843 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:842 msgid "" "http://www.aciri.org/floyd/papers/draft-ipsec-ecn-00.txt[ http://www.aciri." "org/floyd/papers/draft-ipsec-ecn-00.txt], RFC2481 (Explicit Congestion " @@ -2783,7 +2783,7 @@ msgstr "" "Перегрузке), src/sys/netinet6/{ah,esp}_input.c" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:845 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:844 msgid "" "(Thanks goes to Kenjiro Cho mailto:kjc@csl.sony.co.jp[kjc@csl.sony.co.jp] " "for detailed analysis)" @@ -2792,13 +2792,13 @@ msgstr "" "детальный анализ)" #. type: Title ==== -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:846 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:845 #, no-wrap msgid "Interoperability" msgstr "Совместимость" #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:850 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:849 msgid "" "Here are (some of) platforms that KAME code have tested IPsec/IKE " "interoperability in the past. Note that both ends may have modified their " @@ -2809,7 +2809,7 @@ msgstr "" "реализации, поэтому используйте следующий список только в справочных целях." #. type: Plain text -#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:851 +#: documentation/content/en/books/developers-handbook/ipv6/_index.adoc:850 msgid "" "Altiga, Ashley-laurent (vpcom.com), Data Fellows (F-Secure), Ericsson ACC, " "FreeS/WAN, HITACHI, IBM AIX(R), IIJ, Intel, Microsoft(R) Windows NT(R), NIST " diff --git a/documentation/content/ru/books/developers-handbook/kerneldebug/_index.adoc b/documentation/content/ru/books/developers-handbook/kerneldebug/_index.adoc index d430957435..3e3bb38868 100644 --- a/documentation/content/ru/books/developers-handbook/kerneldebug/_index.adoc +++ b/documentation/content/ru/books/developers-handbook/kerneldebug/_index.adoc @@ -75,7 +75,7 @@ endif::[] Содержат только страницы памяти, используемые ядром. Текстовые дампы:: -Содержать захваченные, записанные или интерактивные выходные данные отладчика. +Содержат захваченные, записанные или интерактивные выходные данные отладчика. Минидампы являются типом дампа по умолчанию и в большинстве случаев они сохраняют всю необходимую информацию, присутствующую в полном дампе памяти, так как большинство проблем можно изолировать, используя только состояние ядра. @@ -282,7 +282,7 @@ debug.kdb.panic:panic: kdb_sysctl_panic Если вам требуется выполнить низкоуровневую отладку ядра, доступен отладчик DDB, работающий в режиме реального времени. Он позволяет устанавливать точки останова, выполнять пошаговое выполнение функций ядра, проверять и изменять переменные ядра и т.д. Однако он не имеет доступа к исходным файлам ядра и работает только с глобальными и статическими символами, без доступа к полной отладочной информации, как это делает `kgdb`. -Для настройки ядра с включенной поддержкой DDB добавьте параметры +Для настройки ядра с включённой поддержкой DDB добавьте параметры [.programlisting] .... options KDB diff --git a/documentation/content/ru/books/developers-handbook/kerneldebug/_index.po b/documentation/content/ru/books/developers-handbook/kerneldebug/_index.po index 6a2ec4c77d..f910d9269b 100644 --- a/documentation/content/ru/books/developers-handbook/kerneldebug/_index.po +++ b/documentation/content/ru/books/developers-handbook/kerneldebug/_index.po @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2026-05-09 23:29+0100\n" -"PO-Revision-Date: 2026-05-11 04:45+0000\n" +"POT-Creation-Date: 2026-08-06 22:55+0100\n" +"PO-Revision-Date: 2026-05-18 04:45+0000\n" "Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n" "Language-Team: Russian <https://translate-dev.freebsd.org/projects/" "documentation/booksdevelopers-handbookkerneldebug_index/ru/>\n" @@ -14,8 +14,8 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && " -"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" +"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n" +"%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" "X-Generator: Weblate 4.17\n" #. type: YAML Front Matter: description @@ -37,13 +37,13 @@ msgid "Kernel Debugging" msgstr "Отладка ядра" #. type: Title == -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:56 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:55 #, no-wrap msgid "Obtaining a Kernel Crash Dump" msgstr "Получение аварийного дампа ядра" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:61 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:60 msgid "" "When running a development kernel (e.g., FreeBSD-CURRENT), such as a kernel " "under extreme conditions (e.g., very high load averages, tens of thousands " @@ -61,7 +61,7 @@ msgstr "" "полезную информацию из аварийного дампа." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:66 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:65 msgid "" "A system reboot is inevitable once a kernel panics. Once a system is " "rebooted, the contents of a system's physical memory (RAM) is lost, as well " @@ -79,7 +79,7 @@ msgstr "" "загружается после сбоя, образ ядра может быть извлечен и проведена отладка." #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:72 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:71 msgid "" "A swap device that has been configured as a dump device still acts as a swap " "device. Dumps to non-swap devices (such as tapes or CDRWs, for example) are " @@ -93,47 +93,46 @@ msgstr "" "термина \"раздел подкачки\"." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:75 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:74 msgid "Several types of kernel crash dumps are available:" msgstr "Есть несколько типов аварийных дампов ядра:" #. type: Labeled list -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:76 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:75 #, no-wrap msgid "Full memory dumps" msgstr "Полные дампы памяти" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:78 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:77 msgid "Hold the complete contents of physical memory." msgstr "Содержат полное содержимое физической памяти." #. type: Labeled list -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:79 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:78 #, no-wrap msgid "Minidumps" msgstr "Минидампы" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:81 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:80 msgid "Hold only memory pages in use by the kernel." msgstr "Содержат только страницы памяти, используемые ядром." #. type: Labeled list -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:82 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:81 #, no-wrap msgid "Textdumps" msgstr "Текстовые дампы" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:84 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:83 msgid "Hold captured, scripted, or interactive debugger output." msgstr "" -"Содержать захваченные, записанные или интерактивные выходные данные " -"отладчика." +"Содержат захваченные, записанные или интерактивные выходные данные отладчика." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:86 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:85 msgid "" "Minidumps are the default dump type, and in most cases will capture all " "necessary information present in a full memory dump, as most problems can be " @@ -145,13 +144,13 @@ msgstr "" "ядра." #. type: Title === -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:88 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:87 #, no-wrap msgid "Configuring the Dump Device" msgstr "Настройка устройства дампа" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:96 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:95 msgid "" "Before the kernel will dump the contents of its physical memory to a dump " "device, a dump device must be configured. A dump device is specified by " @@ -180,7 +179,7 @@ msgstr "" "включить аварийные дампы на целевой системе во время процесса установки." #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:100 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:99 msgid "" "Check [.filename]#/etc/fstab# or man:swapinfo[8] for a list of swap devices." msgstr "" @@ -188,7 +187,7 @@ msgstr "" "устройств подкачки." #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:105 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:104 msgid "" "Make sure the `dumpdir` specified in man:rc.conf[5] exists before a kernel " "crash!" @@ -197,7 +196,7 @@ msgstr "" "перед аварией ядра!" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:110 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:109 #, no-wrap msgid "" "# mkdir /var/crash\n" @@ -207,7 +206,7 @@ msgstr "" "# chmod 700 /var/crash\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:113 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:112 msgid "" "Also, remember that the contents of [.filename]#/var/crash# is sensitive and " "very likely contains confidential information such as passwords." @@ -217,13 +216,13 @@ msgstr "" "пароли." #. type: Title === -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:116 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:115 #, no-wrap msgid "Extracting a Kernel Dump" msgstr "Извлечение дампа ядра" #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:122 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:121 msgid "" "Once a dump has been written to a dump device, the dump must be extracted " "before the swap device is mounted. To extract a dump from a dump device, " @@ -244,7 +243,7 @@ msgstr "" "имя файла будет [.filename]#vmcore.0#." #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:126 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:125 msgid "" "In the event that there is already a file called [.filename]#vmcore.0# in [." "filename]#/var/crash# (or whatever `dumpdir` is set to), the kernel will " @@ -264,7 +263,7 @@ msgstr "" "имени последнего дампа." #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:130 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:129 msgid "" "The man:crashinfo[8] utility generates a text file containing a summary of " "information from a full memory dump or minidump. If `dumpdev` has been set " @@ -279,7 +278,7 @@ msgstr "" "filename]#core.txt.N# в каталоге `dumpdir`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:135 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:134 msgid "" "If you are testing a new kernel but need to boot a different one in order to " "get your system up and running again, boot it only into single user mode " @@ -290,7 +289,7 @@ msgstr "" "используя флаг `-s` при загрузке, а затем выполните следующие шаги:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:142 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:141 #, no-wrap msgid "" "# fsck -p\n" @@ -304,7 +303,7 @@ msgstr "" "# exit # exit to multi-user\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:147 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:146 msgid "" "This instructs man:savecore[8] to extract a kernel dump from [.filename]#/" "dev/ad0s1b# and place the contents in [.filename]#/var/crash#. Do not " @@ -319,13 +318,13 @@ msgstr "" "он, скорее всего, отличается от [.filename]#/dev/ad0s1b#!" #. type: Title === -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:149 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:148 #, no-wrap msgid "Testing Kernel Dump Configuration" msgstr "Тестирование конфигурации дампа ядра" #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:154 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:153 msgid "" "The kernel includes a man:sysctl[8] node that requests a kernel panic. This " "can be used to verify that your system is properly configured to save kernel " @@ -340,7 +339,7 @@ msgstr "" "потери данных." #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:164 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:163 #, no-wrap msgid "" "# shutdown now\n" @@ -360,7 +359,7 @@ msgstr "" "...\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:167 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:166 msgid "" "After rebooting, your system should save a dump in [.filename]#/var/crash# " "along with a matching summary from man:crashinfo[8]." @@ -369,13 +368,13 @@ msgstr "" "вместе с соответствующим отчётом из man:crashinfo[8]." #. type: Title == -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:169 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:168 #, no-wrap msgid "Debugging a Kernel Crash Dump with `kgdb`" msgstr "Отладка аварийного дампа ядра с помощью `kgdb`" #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:175 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:174 msgid "" "This section covers man:kgdb[1]. The latest version is included in the " "package:devel/gdb[]." @@ -384,7 +383,7 @@ msgstr "" "devel/gdb[]." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:178 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:177 msgid "" "To enter into the debugger and begin getting information from the dump, " "start kgdb:" @@ -393,13 +392,13 @@ msgstr "" "kgdb:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:182 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:181 #, no-wrap msgid "# kgdb -n N\n" msgstr "# kgdb -n N\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:186 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:185 msgid "" "Where _N_ is the suffix of the [.filename]#vmcore.N# to examine. To open " "the most recent dump use:" @@ -408,13 +407,13 @@ msgstr "" "Чтобы открыть последний дамп, используйте:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:190 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:189 #, no-wrap msgid "# kgdb -n last\n" msgstr "# kgdb -n last\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:194 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:193 msgid "" "Normally, man:kgdb[1] should be able to locate the kernel running at the " "time the dump was generated. If it is not able to locate the correct " @@ -425,13 +424,13 @@ msgstr "" "дампу в качестве двух аргументов для kgdb:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:198 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:197 #, no-wrap msgid "# kgdb /boot/kernel/kernel /var/crash/vmcore.0\n" msgstr "# kgdb /boot/kernel/kernel /var/crash/vmcore.0\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:201 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:200 msgid "" "You can debug the crash dump using the kernel sources just like you can for " "any other program." @@ -440,7 +439,7 @@ msgstr "" "ядра, так же, как и для любой другой программы." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:208 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:207 msgid "" "This dump is from a 5.2-BETA kernel and the crash comes from deep within the " "kernel. The output below has been modified to include line numbers on the " @@ -463,7 +462,7 @@ msgstr "" "списки рассылки, или, может быть, у вас есть возможность его закоммитить!" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:301 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:300 #, no-wrap msgid "" " 1:# cd /usr/obj/usr/src/sys/KERNCONF\n" @@ -649,7 +648,7 @@ msgstr "" "90:(kgdb) quit\n" #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:307 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:306 msgid "" "If your system is crashing regularly and you are running out of disk space, " "deleting old [.filename]#vmcore# files in [.filename]#/var/crash# could save " @@ -660,13 +659,13 @@ msgstr "" "crash# может освободить значительное количество дискового пространства!" #. type: Title == -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:310 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:309 #, no-wrap msgid "On-Line Kernel Debugging Using DDB" msgstr "Онлайн-отладка ядра с использованием DDB" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:314 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:313 msgid "" "While `kgdb` as an off-line debugger provides a very high level of user " "interface, there are some things it cannot do. The most important ones " @@ -678,7 +677,7 @@ msgstr "" "пошаговое выполнение кода ядра." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:318 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:317 msgid "" "If you need to do low-level debugging on your kernel, there is an on-line " "debugger available called DDB. It allows setting of breakpoints, single-" @@ -695,24 +694,24 @@ msgstr "" "отладочной информации, как это делает `kgdb`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:320 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:319 msgid "To configure your kernel to include DDB, add the options" -msgstr "Для настройки ядра с включенной поддержкой DDB добавьте параметры" +msgstr "Для настройки ядра с включённой поддержкой DDB добавьте параметры" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:323 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:322 #, no-wrap msgid "options KDB\n" msgstr "options KDB\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:328 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:327 #, no-wrap msgid "options DDB\n" msgstr "options DDB\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:332 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:331 msgid "" "to your config file, and rebuild. (See extref:{handbook}[The FreeBSD " "Handbook] for details on configuring the FreeBSD kernel)." @@ -721,7 +720,7 @@ msgstr "" "FreeBSD см. в extref:{handbook}[Руководстве FreeBSD])." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:338 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:337 msgid "" "Once your DDB kernel is running, there are several ways to enter DDB. The " "first, and earliest way is to use the boot flag `-d`. The kernel will start " @@ -737,7 +736,7 @@ msgstr "" "меню загрузки загрузчика и введите `boot -d` в командной строке загрузчика." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:342 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:341 msgid "" "The second scenario is to drop to the debugger once the system has booted. " "There are two simple ways to accomplish this. If you would like to break to " @@ -748,13 +747,13 @@ msgstr "" "строки, просто введите команду:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:346 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:345 #, no-wrap msgid "# sysctl debug.kdb.enter=1\n" msgstr "# sysctl debug.kdb.enter=1\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:353 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:352 msgid "" "Alternatively, if you are at the system console, you may use a hot-key on " "the keyboard. The default break-to-debugger sequence is kbd:[Ctrl+Alt" @@ -778,7 +777,7 @@ msgstr "" "излишне генерируют условие BREAK, например, при отключении кабеля." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:356 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:355 msgid "" "The third way is that any panic condition will branch to DDB if the kernel " "is configured to use it. For this reason, it is not wise to configure a " @@ -789,23 +788,23 @@ msgstr "" "рекомендуется настраивать ядро с DDB для машины, работающей без присмотра." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:358 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:357 msgid "To obtain the unattended functionality, add:" msgstr "Для получения неинтерактивной функциональности добавьте:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:362 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:361 #, no-wrap msgid "options\tKDB_UNATTENDED\n" msgstr "options\tKDB_UNATTENDED\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:365 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:364 msgid "to the kernel configuration file and rebuild/reinstall." msgstr "в файл конфигурации ядра и пересоберите/переустановите ядро." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:368 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:367 msgid "" "The DDB commands roughly resemble some `gdb` commands. The first thing you " "probably need to do is to set a breakpoint:" @@ -814,13 +813,13 @@ msgstr "" "вероятно, нужно сделать, это установить точку останова:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:372 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:371 #, no-wrap msgid " break function-name address\n" msgstr " break function-name address\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:377 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:376 msgid "" "Numbers are taken hexadecimal by default, but to make them distinct from " "symbol names; hexadecimal numbers starting with the letters `a-f` need to be " @@ -833,29 +832,29 @@ msgstr "" "Допускаются простые выражения, например: `function-name + 0x103`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:379 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:378 msgid "To exit the debugger and continue execution, type:" msgstr "Для выхода из отладчика и продолжения выполнения введите:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:383 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:382 #, no-wrap msgid " continue\n" msgstr " continue\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:386 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:385 msgid "To get a stack trace of the current thread, use:" msgstr "Для получения трассировки стека текущего потока используйте:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:390 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:389 #, no-wrap msgid " trace\n" msgstr " trace\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:393 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:392 msgid "" "To get a stack trace of an arbitrary thread, specify a process ID or thread " "ID as a second argument to `trace`." @@ -865,12 +864,12 @@ msgstr "" "`trace`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:395 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:394 msgid "If you want to remove a breakpoint, use" msgstr "Если вы хотите удалить точку останова, используйте" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:400 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:399 #, no-wrap msgid "" " del\n" @@ -880,7 +879,7 @@ msgstr "" " del address-expression\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:404 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:403 msgid "" "The first form will be accepted immediately after a breakpoint hit, and " "deletes the current breakpoint. The second form can remove any breakpoint, " @@ -891,35 +890,35 @@ msgstr "" "необходимо указать точный адрес; его можно получить из:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:408 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:407 #, no-wrap msgid " show b\n" msgstr " show b\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:411 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:410 msgid "or:" msgstr "или:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:415 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:414 #, no-wrap msgid " show break\n" msgstr " show break\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:418 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:417 msgid "To single-step the kernel, try:" msgstr "Для пошагового выполнения ядра попробуйте:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:422 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:421 #, no-wrap msgid " s\n" msgstr " s\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:425 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:424 msgid "" "This will step into functions, but you can make DDB trace them until the " "matching return statement is reached by:" @@ -928,13 +927,13 @@ msgstr "" "достижения соответствующего оператора return с помощью:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:429 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:428 #, no-wrap msgid " n\n" msgstr " n\n" #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:435 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:434 msgid "" "This is different from ``gdb``'s `next` statement; it is like ``gdb``'s " "`finish`. Pressing kbd:[n] more than once will cause a continue." @@ -943,12 +942,12 @@ msgstr "" "``gdb``. Нажатие kbd:[n] более одного раза приведёт к продолжению." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:438 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:437 msgid "To examine data from memory, use (for example):" msgstr "Для просмотра данных в памяти используйте (например):" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:445 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:444 #, no-wrap msgid "" " x/wx 0xf0133fe0,40\n" @@ -962,7 +961,7 @@ msgstr "" " x/s stringbuf\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:450 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:449 msgid "" "for word/halfword/byte access, and hexadecimal/decimal/character/ string " "display. The number after the comma is the object count. To display the " @@ -973,24 +972,24 @@ msgstr "" "количество объектов. Для отображения следующих 0x10 элементов просто введите:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:454 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:453 #, no-wrap msgid " x ,10\n" msgstr " x ,10\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:457 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:456 msgid "Similarly, use" msgstr "Аналогично, используйте" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:461 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:460 #, no-wrap msgid " x/ia foofunc,10\n" msgstr " x/ia foofunc,10\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:464 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:463 msgid "" "to disassemble the first 0x10 instructions of `foofunc`, and display them " "along with their offset from the beginning of `foofunc`." @@ -999,12 +998,12 @@ msgstr "" "отображения вместе с их смещением от начала `foofunc`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:466 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:465 msgid "To modify memory, use the write command:" msgstr "Для записи в память используйте команду write:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:471 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:470 #, no-wrap msgid "" " w/b termbuf 0xa 0xb 0\n" @@ -1014,7 +1013,7 @@ msgstr "" " w/w 0xf0010030 0 0\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:475 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:474 msgid "" "The command modifier (`b`/`h`/`w`) specifies the size of the data to be " "written, the first following expression is the address to write to and the " @@ -1025,70 +1024,70 @@ msgstr "" "интерпретируется как данные для записи в последующие ячейки памяти." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:477 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:476 msgid "If you need to know the current registers, use:" msgstr "Если вам необходимо узнать текущее содержимое регистров, введите:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:481 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:480 #, no-wrap msgid " show reg\n" msgstr " show reg\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:484 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:483 msgid "Alternatively, you can display a single register value by e.g." msgstr "Также можно отобразить значение одного регистра, например:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:488 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:487 #, no-wrap msgid " p $eax\n" msgstr " p $eax\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:491 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:490 msgid "and modify it by:" msgstr "и изменить его с помощью:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:495 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:494 #, no-wrap msgid " set $eax new-value\n" msgstr " set $eax new-value\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:498 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:497 msgid "Should you need to call some kernel functions from DDB, simply say:" msgstr "" "Если вам потребуется вызвать некоторые функции ядра из DDB, просто напишите:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:502 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:501 #, no-wrap msgid " call func(arg1, arg2, ...)\n" msgstr " call func(arg1, arg2, ...)\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:505 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:504 msgid "The return value will be printed." msgstr "Будет выведено возвращаемое значение." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:507 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:506 msgid "For a man:ps[1] style summary of all running processes, use:" msgstr "" "Для вывода информации о всех запущенных процессах в стиле man:ps[1] " "используйте:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:511 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:510 #, no-wrap msgid " ps\n" msgstr " ps\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:516 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:515 msgid "" "Now you have examined why your kernel failed, and you wish to reboot. " "Remember that, depending on the severity of previous malfunctioning, not all " @@ -1101,13 +1100,13 @@ msgstr "" "завершения работы и перезагрузки системы:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:520 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:519 #, no-wrap msgid " panic\n" msgstr " panic\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:523 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:522 msgid "" "This will cause your kernel to dump core and reboot, so you can later " "analyze the core on a higher level with man:kgdb[1]." @@ -1116,13 +1115,13 @@ msgstr "" "проанализировать дамп на более высоком уровне с помощью man:kgdb[1]." #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:527 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:526 #, no-wrap msgid " call boot(0)\n" msgstr " call boot(0)\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:531 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:530 msgid "" "Might be a good way to cleanly shut down the running system, `sync()` all " "disks, and finally, in some cases, reboot. As long as the disk and " @@ -1135,13 +1134,13 @@ msgstr "" "хорошим способом для почти чистого завершения работы." #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:535 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:534 #, no-wrap msgid " reset\n" msgstr " reset\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:538 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:537 msgid "" "This is the final way out of disaster and almost the same as hitting the Big " "Red Button." @@ -1150,18 +1149,18 @@ msgstr "" "на Большую Красную Кнопку." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:540 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:539 msgid "If you need a short command summary, simply type:" msgstr "Если вам нужна краткая сводка команд, просто введите:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:544 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:543 #, no-wrap msgid " help\n" msgstr " help\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:548 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:547 msgid "" "It is highly recommended to have a printed copy of the man:ddb[4] manual " "page ready for a debugging session. Remember that it is hard to read the on-" @@ -1172,13 +1171,13 @@ msgstr "" "время пошагового выполнения ядра сложно." #. type: Title == -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:550 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:549 #, no-wrap msgid "On-Line Kernel Debugging Using Remote GDB" msgstr "Онлайн-отладка ядра с использованием удалённого GDB" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:553 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:552 msgid "" "The FreeBSD kernel provides a second KDB backend for on-line debugging: man:" "gdb[4]." @@ -1187,7 +1186,7 @@ msgstr "" "man:gdb[4]." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:559 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:558 msgid "" "GDB has supported _remote debugging_ for a long time. This is done using a " "very simple protocol along a serial line. Unlike the other debugging " @@ -1206,7 +1205,7 @@ msgstr "" "информации)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:561 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:560 msgid "" "In order to use remote GDB, ensure that the following options are present in " "your kernel configuration:" @@ -1215,7 +1214,7 @@ msgstr "" "присутствуют в конфигурации вашего ядра:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:566 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:565 #, no-wrap msgid "" "makeoptions DEBUG=-g\n" @@ -1227,7 +1226,7 @@ msgstr "" "options GDB\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:569 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:568 msgid "" "Note that the `GDB` option is turned off by default in `GENERIC` kernels on -" "STABLE and -RELEASE branches, but enabled on -CURRENT." @@ -1236,7 +1235,7 @@ msgstr "" "для веток -STABLE и -RELEASE, но включена в -CURRENT." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:573 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:572 msgid "" "Once built, copy the kernel to the target machine, and boot it. Connect the " "serial line of the target machine that has \"flags 080\" set on its uart " @@ -1250,7 +1249,7 @@ msgstr "" "uart[4]." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:576 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:575 msgid "" "The target machine must be made to enter the GDB backend, either due to a " "panic or by taking a purposeful trap into the debugger. Before doing this, " @@ -1261,7 +1260,7 @@ msgstr "" "бэкенд отладчика GDB:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:580 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:579 #, no-wrap msgid "" "# sysctl debug.kdb.current=gdb\n" @@ -1271,7 +1270,7 @@ msgstr "" "debug.kdb.current: ddb -> gdb\n" #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:587 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:586 msgid "" "The supported backends can be listed by the `debug.kdb.available` sysctl. " "If the kernel configuration includes `options DDB`, then man:ddb[4] will be " @@ -1284,12 +1283,12 @@ msgstr "" "последовательный порт отладки может быть настроен неправильно." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:590 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:589 msgid "Then, force entry to the debugger:" msgstr "Затем принудительно войдите в отладчик:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:594 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:593 #, no-wrap msgid "" "# sysctl debug.kdb.enter=1\n" @@ -1299,7 +1298,7 @@ msgstr "" "debug.kdb.enter: 0KDB: enter: sysctl debug.kdb.enter\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:598 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:597 msgid "" "The target machine now awaits connection from a remote GDB client. On the " "debugging machine, go to the compile directory of the target kernel, and " @@ -1310,7 +1309,7 @@ msgstr "" "`gdb`:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:609 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:608 #, no-wrap msgid "" "# cd /usr/obj/usr/src/amd64.amd64/sys/GENERIC/\n" @@ -1332,7 +1331,7 @@ msgstr "" "(kgdb)\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:612 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:611 msgid "" "Initialize the remote debugging session (assuming the first serial port is " "being used) by:" @@ -1341,18 +1340,18 @@ msgstr "" "первый последовательный порт) с помощью:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:616 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:615 #, no-wrap msgid "(kgdb) target remote /dev/cuau0\n" msgstr "(kgdb) target remote /dev/cuau0\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:619 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:618 msgid "Your hosting GDB will now gain control over the target kernel:" msgstr "Ваш хостинг GDB теперь получит контроль над целевым ядром:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:626 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:625 #, no-wrap msgid "" "Remote debugging using /dev/cuau0\n" @@ -1366,7 +1365,7 @@ msgstr "" "(kgdb)\n" #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:634 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:633 msgid "" "Depending on the compiler used, some local variables may appear as " "`<optimized out>`, preventing them from being inspected directly by `gdb`. " @@ -1385,7 +1384,7 @@ msgstr "" "(или вообще не проявляться) при изменении уровня оптимизации." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:638 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:637 msgid "" "You can use this session almost as any other GDB session, including full " "access to the source, running it in gud-mode inside an Emacs window (which " @@ -1397,13 +1396,13 @@ msgstr "" "другом окне Emacs) и т.д." #. type: Title == -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:640 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:639 #, no-wrap msgid "Debugging a Console Driver" msgstr "Отладка драйвера консоли" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:646 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:645 msgid "" "Since you need a console driver to run DDB on, things are more complicated " "if the console driver itself is failing. You might remember the use of a " @@ -1420,13 +1419,13 @@ msgstr "" "настроенным драйвером консоли, включая последовательную консоль." #. type: Title == -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:648 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:647 #, no-wrap msgid "Debugging Deadlocks" msgstr "Отладка взаимоблокировок" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:653 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:652 msgid "" "You may experience so called deadlocks, a situation where a system stops " "doing useful work. To provide a helpful bug report in this situation, use " @@ -1440,7 +1439,7 @@ msgstr "" "для подозрительных процессов." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:657 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:656 msgid "" "If possible, consider doing further investigation. The recipe below is " "especially useful if you suspect that a deadlock occurs in the VFS layer. " @@ -1452,7 +1451,7 @@ msgstr "" "конфигурации ядра." #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:668 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:667 #, no-wrap msgid "" "makeoptions \tDEBUG=-g\n" @@ -1474,7 +1473,7 @@ msgstr "" "options \tDIAGNOSTIC\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:671 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:670 msgid "" "When a deadlock occurs, in addition to the output of the `ps` command, " "provide information from the `show pcpu`, `show allpcpu`, `show locks`, " @@ -1485,7 +1484,7 @@ msgstr "" "`show lockedvnods` и `alltrace`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:673 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:672 msgid "" "To obtain meaningful backtraces for threaded processes, use `thread thread-" "id` to switch to the thread stack, and do a backtrace with `where`." @@ -1495,13 +1494,13 @@ msgstr "" "трассировку с помощью `where`." #. type: Title == -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:675 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:674 #, no-wrap msgid "Kernel debugging with Dcons" msgstr "Отладка ядра с помощью Dcons" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:681 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:680 msgid "" "man:dcons[4] is a very simple console driver that is not directly connected " "with any physical devices. It just reads and writes characters from and to " @@ -1518,13 +1517,13 @@ msgstr "" "извне ядра с помощью man:dconschat[8]." #. type: Title === -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:682 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:681 #, no-wrap msgid "Dcons over FireWire(R)" msgstr "Dcons через FireWire(R)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:690 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:689 msgid "" "Most FireWire(R) (IEEE1394) host controllers are based on the OHCI " "specification that supports physical access to the host memory. This means " @@ -1546,7 +1545,7 @@ msgstr "" "буфер man:dcons[4] остаётся доступным даже при крахе системы." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:693 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:692 msgid "" "FireWire(R) devices are not limited to those integrated into motherboards. " "PCI cards exist for desktops, and a cardbus interface can be purchased for " @@ -1557,20 +1556,20 @@ msgstr "" "приобрести интерфейс CardBus." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:694 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:693 #, no-wrap msgid "Enabling FireWire(R) and Dcons support on the target machine" msgstr "Включение поддержки FireWire(R) и Dcons на целевой машине" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:697 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:696 msgid "" "To enable FireWire(R) and Dcons support in the kernel of the _target " "machine_:" msgstr "Чтобы включить поддержку FireWire(R) и Dcons в ядре _целевой машины_:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:699 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:698 msgid "" "Make sure your kernel supports `dcons`, `dcons_crom` and `firewire`. `Dcons` " "should be statically linked with the kernel. For `dcons_crom` and " @@ -1581,7 +1580,7 @@ msgstr "" "модули должны подойти." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:700 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:699 msgid "" "Make sure physical DMA is enabled. You may need to add `hw.firewire." "phydma_enable=1` to [.filename]#/boot/loader.conf#." @@ -1590,12 +1589,12 @@ msgstr "" "firewire.phydma_enable=1` в [.filename]#/boot/loader.conf#." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:701 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:700 msgid "Add options for debugging." msgstr "Добавьте параметры для отладки." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:702 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:701 msgid "" "Add `dcons_gdb=1` in [.filename]#/boot/loader.conf# if you use GDB over " "FireWire(R)." @@ -1604,12 +1603,12 @@ msgstr "" "GDB через FireWire(R)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:703 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:702 msgid "Enable `dcons` in [.filename]#/etc/ttys#." msgstr "Включите `dcons` в [.filename]#/etc/ttys#." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:704 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:703 msgid "" "Optionally, to force `dcons` to be the high-level console, add `hw.firewire." "dcons_crom.force_console=1` to [.filename]#loader.conf#." @@ -1619,7 +1618,7 @@ msgstr "" "filename]#loader.conf#." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:706 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:705 msgid "" "To enable FireWire(R) and Dcons support in man:loader[8] on i386 or amd64:" msgstr "" @@ -1627,7 +1626,7 @@ msgstr "" "amd64:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:708 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:707 msgid "" "Add `LOADER_FIREWIRE_SUPPORT=YES` in [.filename]#/etc/make.conf# and rebuild " "man:loader[8]:" @@ -1636,13 +1635,13 @@ msgstr "" "пересоберите man:loader[8]:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:712 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:711 #, no-wrap msgid "# cd /sys/boot/i386 && make clean && make && make install\n" msgstr "# cd /sys/boot/i386 && make clean && make && make install\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:715 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:714 msgid "" "To enable man:dcons[4] as an active low-level console, add `boot_multicons=" "\"YES\"` to [.filename]#/boot/loader.conf#." @@ -1651,7 +1650,7 @@ msgstr "" "добавьте `boot_multicons=\"YES\"` в [.filename]#/boot/loader.conf#." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:718 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:717 msgid "" "Here are a few configuration examples. A sample kernel configuration file " "would contain:" @@ -1660,7 +1659,7 @@ msgstr "" "содержать:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:727 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:726 #, no-wrap msgid "" "device dcons\n" @@ -1678,12 +1677,12 @@ msgstr "" "options ALT_BREAK_TO_DEBUGGER\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:730 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:729 msgid "And a sample [.filename]#/boot/loader.conf# would contain:" msgstr "И образец [.filename]#/boot/loader.conf# может содержать:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:738 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:737 #, no-wrap msgid "" "dcons_crom_load=\"YES\"\n" @@ -1699,24 +1698,24 @@ msgstr "" "hw.firewire.dcons_crom.force_console=1\n" #. type: Title ==== -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:740 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:739 #, no-wrap msgid "Enabling FireWire(R) and Dcons support on the host machine" msgstr "Включение поддержки FireWire(R) и Dcons на главной машине" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:743 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:742 msgid "To enable FireWire(R) support in the kernel on the _host machine_:" msgstr "Чтобы включить поддержку FireWire(R) в ядре на _основной машине_:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:747 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:746 #, no-wrap msgid "# kldload firewire\n" msgstr "# kldload firewire\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:750 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:749 msgid "" "Find out the EUI64 (the unique 64 bit identifier) of the FireWire(R) host " "controller, and use man:fwcontrol[8] or `dmesg` to find the EUI64 of the " @@ -1727,18 +1726,18 @@ msgstr "" "целевой машины." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:752 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:751 msgid "Run man:dconschat[8], with:" msgstr "Запустите man:dconschat[8], с:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:756 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:755 #, no-wrap msgid "# dconschat -e \\# -br -G 12345 -t 00-11-22-33-44-55-66-77\n" msgstr "# dconschat -e \\# -br -G 12345 -t 00-11-22-33-44-55-66-77\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:759 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:758 msgid "" "The following key combinations can be used once man:dconschat[8] is running:" msgstr "" @@ -1746,69 +1745,69 @@ msgstr "" "dconschat[8]:" #. type: Table -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:765 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:764 #, no-wrap msgid "kbd:[~+.]" msgstr "kbd:[~+.]" #. type: Table -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:767 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:766 #, no-wrap msgid "Disconnect" msgstr "Отсоединиться" #. type: Table -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:768 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:771 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:774 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:767 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:770 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:773 #, no-wrap msgid "kbd:[~]" msgstr "kbd:[~]" #. type: Table -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:770 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:769 #, no-wrap msgid "ALT BREAK" msgstr "ALT BREAK" #. type: Table -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:773 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:772 #, no-wrap msgid "RESET target" msgstr "ПЕРЕЗАГРУЗИТЬ (RESET) целевую машину" #. type: Table -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:775 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:774 #, no-wrap msgid "Suspend dconschat" msgstr "Приостановить dconschat" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:778 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:777 msgid "" "Attach remote GDB by starting man:kgdb[1] with a remote debugging session:" msgstr "" "Присоедините удалённый GDB, запустив man:kgdb[1] с сеансом удалённой отладки:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:782 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:781 #, no-wrap msgid " kgdb -r :12345 kernel\n" msgstr " kgdb -r :12345 kernel\n" #. type: Title ==== -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:784 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:783 #, no-wrap msgid "Some general tips" msgstr "Некоторые общие рекомендации" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:787 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:786 msgid "Here are some general tips:" msgstr "Вот несколько общих советов:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:789 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:788 msgid "" "To take full advantage of the speed of FireWire(R), disable other slow " "console drivers:" @@ -1817,7 +1816,7 @@ msgstr "" "медленные драйверы консоли:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:794 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:793 #, no-wrap msgid "" "# conscontrol delete ttyd0\t # serial console\n" @@ -1827,7 +1826,7 @@ msgstr "" "# conscontrol delete consolectl\t# video/keyboard\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:797 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:796 msgid "" "There exists a GDB mode for man:emacs[1]; this is what you will need to add " "to your [.filename]#.emacs#:" @@ -1836,7 +1835,7 @@ msgstr "" "filename]#.emacs#:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:804 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:803 #, no-wrap msgid "" "(setq gud-gdba-command-name \"kgdb -a -a -a -r :12345\")\n" @@ -1850,13 +1849,13 @@ msgstr "" "M-x gdba\n" #. type: Title === -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:806 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:805 #, no-wrap msgid "Dcons with KVM" msgstr "Dcons с KVM" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:810 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:809 msgid "" "We can directly read the man:dcons[4] buffer via [.filename]#/dev/mem# for " "live systems, and in the core dump for crashed systems. These give you " @@ -1869,45 +1868,45 @@ msgstr "" "информации." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:811 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:810 #, no-wrap msgid "Using Dcons with KVM" msgstr "Использование Dcons с KVM" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:814 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:813 msgid "To use man:dcons[4] with KVM:" msgstr "Для использования man:dcons[4] с KVM:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:816 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:815 msgid "Dump a man:dcons[4] buffer of a live system:" msgstr "Дамп буфера man:dcons[4] работающей системы:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:820 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:819 #, no-wrap msgid "# dconschat -1\n" msgstr "# dconschat -1\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:823 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:822 msgid "Dump a man:dcons[4] buffer of a crash dump:" msgstr "Дамп буфера man:dcons[4] аварийного дампа:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:827 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:826 #, no-wrap msgid "# dconschat -1 -M vmcore.XX\n" msgstr "# dconschat -1 -M vmcore.XX\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:830 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:829 msgid "Live core debugging can be done via:" msgstr "Отладка ядра в реальном времени может быть выполнена через:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:835 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:834 #, no-wrap msgid "" "# fwcontrol -m target_eui64\n" @@ -1917,13 +1916,13 @@ msgstr "" "# kgdb kernel /dev/fwmem0.2\n" #. type: Title == -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:838 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:837 #, no-wrap msgid "Glossary of Kernel Options for Debugging" msgstr "Глоссарий параметров ядра для отладки" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:841 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:840 msgid "" "This section provides a brief glossary of compile-time kernel options used " "for debugging:" @@ -1932,7 +1931,7 @@ msgstr "" "при компиляции и относящихся к отладке:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:843 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:842 msgid "" "`options KDB`: compiles in the kernel debugger framework. Required for " "`options DDB` and `options GDB`. Little or no performance overhead. By " @@ -1944,7 +1943,7 @@ msgstr "" "отладчик будет запущен при панике вместо автоматической перезагрузки." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:844 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:843 msgid "" "`options KDB_UNATTENDED`: change the default value of the `debug." "debugger_on_panic` sysctl to 0, which controls whether the debugger is " @@ -1965,7 +1964,7 @@ msgstr "" "не готовы использовать отладчик для диагностики, используйте эту опцию." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:845 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:844 msgid "" "`options KDB_TRACE`: change the default value of the `debug.trace_on_panic` " "sysctl to 1, which controls whether the debugger automatically prints a " @@ -1981,7 +1980,7 @@ msgstr "" "восстановления." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:846 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:845 msgid "" "`options DDB`: compile in support for the console debugger, DDB. This " "interactive debugger runs on whatever the active low-level console of the " @@ -2007,7 +2006,7 @@ msgstr "" "опция зависит от `options KDB`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:847 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:846 msgid "" "`options GDB`: compile in support for the remote debugger, GDB, which can " "operate over serial cable or firewire. When the debugger is entered, GDB may " @@ -2035,7 +2034,7 @@ msgstr "" "`options KDB`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:848 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:847 msgid "" "`options BREAK_TO_DEBUGGER`, `options ALT_BREAK_TO_DEBUGGER`: allow a break " "signal or alternative signal on the console to enter the debugger. If the " @@ -2053,7 +2052,7 @@ msgstr "" "производительность." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:849 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:848 msgid "" "`options INVARIANTS`: compile into the kernel a large number of run-time " "assertion checks and tests, which constantly test the integrity of kernel " @@ -2076,7 +2075,7 @@ msgstr "" "накладных расходов. Эта опция зависит от `options INVARIANT_SUPPORT`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:850 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:849 msgid "" "`options INVARIANT_SUPPORT`: many of the tests present in `options " "INVARIANTS` require modified data structures or additional kernel symbols to " @@ -2087,7 +2086,7 @@ msgstr "" "дополнительных символов ядра." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:851 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:850 msgid "" "`options WITNESS`: this option enables run-time lock order tracking and " "verification, and is an invaluable tool for deadlock diagnosis. WITNESS " @@ -2113,7 +2112,7 @@ msgstr "" "доступна в man:witness[4]." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:852 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:851 msgid "" "`options WITNESS_SKIPSPIN`: disable run-time checking of spinlock lock order " "with WITNESS. As spin locks are acquired most frequently in the scheduler, " @@ -2127,7 +2126,7 @@ msgstr "" "зависит от `options WITNESS`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:853 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:852 msgid "" "`options WITNESS_KDB`: change the default value of the `debug.witness.kdb` " "sysctl to 1, which causes WITNESS to enter the debugger when a lock order " @@ -2140,7 +2139,7 @@ msgstr "" "опция зависит от `options WITNESS`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:854 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:853 msgid "" "`options SOCKBUF_DEBUG`: perform extensive run-time consistency checking on " "socket buffers, which can be useful for debugging both socket bugs and race " @@ -2156,7 +2155,7 @@ msgstr "" "гонки драйверов устройств." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:855 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:854 msgid "" "`options DEBUG_VFS_LOCKS`: track lock acquisition points for lockmgr/vnode " "locks, expanding the amount of information displayed by `show lockedvnods` " @@ -2168,7 +2167,7 @@ msgstr "" "производительность." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:856 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:855 msgid "" "`options DEBUG_MEMGUARD`: a replacement for the man:malloc[9] kernel memory " "allocator that uses the VM system to detect reads or writes from allocated " @@ -2183,7 +2182,7 @@ msgstr "" "при отладке ошибок повреждения памяти ядра." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:857 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:856 msgid "" "`options DIAGNOSTIC`: enable additional, more expensive diagnostic tests " "along the lines of `options INVARIANTS`." @@ -2192,7 +2191,7 @@ msgstr "" "диагностические тесты, аналогичные `options INVARIANTS`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:858 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:857 msgid "" "`options KASAN`: enable the Kernel Address Sanitizer. This enables compiler " "instrumentation which can be used to detect invalid memory accesses in the " @@ -2208,7 +2207,7 @@ msgstr "" "поддерживаемых платформ см. в man:kasan[9]." #. type: Plain text -#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:858 +#: documentation/content/en/books/developers-handbook/kerneldebug/_index.adoc:857 msgid "" "`options KMSAN`: enable the Kernel Memory Sanitizer. This enables compiler " "instrumentation which can be used to detect uses of uninitialized memory. " diff --git a/documentation/content/ru/books/developers-handbook/partiv.adoc b/documentation/content/ru/books/developers-handbook/partiv.adoc index c4af681fbe..1256b13914 100644 --- a/documentation/content/ru/books/developers-handbook/partiv.adoc +++ b/documentation/content/ru/books/developers-handbook/partiv.adoc @@ -5,7 +5,7 @@ params: prev: books/developers-handbook/kerneldebug showBookMenu: 'true' title: 'Часть IV. Приложения' -weight: 16 +weight: 14 --- [[appendices]] diff --git a/documentation/content/ru/books/developers-handbook/partiv.po b/documentation/content/ru/books/developers-handbook/partiv.po index 787827066d..db278c3f64 100644 --- a/documentation/content/ru/books/developers-handbook/partiv.po +++ b/documentation/content/ru/books/developers-handbook/partiv.po @@ -1,12 +1,12 @@ # SOME DESCRIPTIVE TITLE # Copyright (C) YEAR The FreeBSD Project # This file is distributed under the same license as the FreeBSD Documentation package. -# Vladlen Popolitov <vladlenpopolitov@list.ru>, 2025. +# Vladlen Popolitov <vladlenpopolitov@list.ru>, 2025, 2026. msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2025-05-01 19:56-0300\n" -"PO-Revision-Date: 2025-06-22 04:45+0000\n" +"POT-Creation-Date: 2026-04-16 15:39-0300\n" +"PO-Revision-Date: 2026-08-08 04:45+0000\n" "Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n" "Language-Team: Russian <https://translate-dev.freebsd.org/projects/" "documentation/booksdevelopers-handbookpartiv/ru/>\n" @@ -21,11 +21,15 @@ msgstr "" #. type: YAML Front Matter: title #: documentation/content/en/books/developers-handbook/partiv.adoc:1 #, no-wrap -msgid "Part IV. Architectures" -msgstr "Часть IV. Архитектуры" +msgid "Part IV. Appendices" +msgstr "Часть IV. Приложения" #. type: Title = #: documentation/content/en/books/developers-handbook/partiv.adoc:12 #, no-wrap -msgid "Architectures" -msgstr "Архитектуры" +msgid "Appendices" +msgstr "Приложения" + +#, no-wrap +#~ msgid "Architectures" +#~ msgstr "Архитектуры" diff --git a/documentation/content/ru/books/developers-handbook/policies/_index.adoc b/documentation/content/ru/books/developers-handbook/policies/_index.adoc index c020f1e5ef..59a29dbde2 100644 --- a/documentation/content/ru/books/developers-handbook/policies/_index.adoc +++ b/documentation/content/ru/books/developers-handbook/policies/_index.adoc @@ -104,13 +104,13 @@ MAINTAINER= email-addresses [[policies-encumbered]] == Файлы с правовыми ограничениями -Время от времени может возникнуть необходимость включить файл с правовыми ограничениями (обремененными лицензиями, патентами) в дерево исходного кода FreeBSD. Например, если устройство требует загрузки небольшого бинарного кода перед началом работы, а у нас нет исходного кода для него, то такой бинарный файл считается обремененным. Следующие политики применяются к включению обремененных файлов в дерево исходного кода FreeBSD. +Время от времени может возникнуть необходимость включить файл с правовыми ограничениями (обременёнными лицензиями, патентами) в дерево исходного кода FreeBSD. Например, если устройство требует загрузки небольшого бинарного кода перед началом работы, а у нас нет исходного кода для него, то такой бинарный файл считается обременённым. Следующие политики применяются к включению обременённых файлов в дерево исходного кода FreeBSD. . Любой файл, который интерпретируется или выполняется процессором(-ами) системы и не представлен в исходном формате, является обременённым. . Любой файл с лицензией более ограничительной, чем BSD или GNU, является обременённым. -. Файл, содержащий загружаемые двоичные данные для использования оборудованием, не является обремененным, если к нему не применяется пункт (1) или (2). +. Файл, содержащий загружаемые двоичные данные для использования оборудованием, не является обременённым, если к нему не применяется пункт (1) или (2). . Любой файл с правовыми ограничениями требует специального одобрения от link:https://www.FreeBSD.org/administration/#t-core[Основной команды (Core Team)] перед добавлением в репозиторий. -. Обремененные файлы помещаются в [.filename]#src/contrib# или [.filename]#src/sys/contrib#. +. Обременённые файлы помещаются в [.filename]#src/contrib# или [.filename]#src/sys/contrib#. . Весь модуль должен храниться вместе. Нет смысла разделять его, если только нет совместного использования кода с необременённой частью кода. . В прошлом бинарные файлы обычно кодировались с помощью uuencode и назывались [.filename]#arch/filename.o.uu#. Теперь в этом нет необходимости, и бинарные файлы могут добавляться в репозиторий без изменений. . Файлы ядра системы: diff --git a/documentation/content/ru/books/developers-handbook/policies/_index.po b/documentation/content/ru/books/developers-handbook/policies/_index.po index 0afe78232d..1bcd2366c7 100644 --- a/documentation/content/ru/books/developers-handbook/policies/_index.po +++ b/documentation/content/ru/books/developers-handbook/policies/_index.po @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2025-06-29 21:20+0100\n" -"PO-Revision-Date: 2026-03-04 20:01+0000\n" +"POT-Creation-Date: 2026-08-06 22:55+0100\n" +"PO-Revision-Date: 2026-05-18 04:45+0000\n" "Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n" "Language-Team: Russian <https://translate-dev.freebsd.org/projects/" "documentation/booksdevelopers-handbookpolicies_index/ru/>\n" @@ -14,8 +14,8 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && " -"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" +"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n" +"%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" "X-Generator: Weblate 4.17\n" #. type: Title = @@ -32,7 +32,7 @@ msgid "Chapter 5. Source Tree Guidelines and Policies" msgstr "Глава 5. Руководство и политика работы с деревом исходного кода" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:55 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:54 msgid "" "This chapter documents various guidelines and policies in force for the " "FreeBSD source tree." @@ -41,13 +41,13 @@ msgstr "" "дерева исходных кодов FreeBSD." #. type: Title == -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:57 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:56 #, no-wrap msgid "Style Guidelines" msgstr "Рекомендации по стилю" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:61 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:60 msgid "" "Consistent coding style is extremely important, particularly with large " "projects like FreeBSD. Code should follow the FreeBSD coding styles " @@ -58,13 +58,13 @@ msgstr "" "программирования FreeBSD, описанным в man:style[9] и man:style.Makefile[5]." #. type: Title == -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:63 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:62 #, no-wrap msgid "`MAINTAINER` on Makefiles" msgstr "`MAINTAINER` в Makefile-ах" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:67 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:66 msgid "" "If a particular portion of the FreeBSD [.filename]#src/# distribution is " "being maintained by a person or group of persons, this is communicated " @@ -80,13 +80,13 @@ msgstr "" "filename]#Makefile# соответствующего порта:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:71 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:70 #, no-wrap msgid "MAINTAINER= email-addresses\n" msgstr "MAINTAINER= email-addresses\n" #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:78 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:77 msgid "" "For other parts of the repository, or for sections not listed as having a " "maintainer, or when you are unsure who the active maintainer is, try looking " @@ -107,12 +107,12 @@ msgstr "" "проверку из вежливости — вполне разумное действие." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:81 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:80 msgid "The role of the maintainer is as follows:" msgstr "Роль сопровождающего заключается в следующем:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:83 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:82 msgid "" "The maintainer owns and is responsible for that code. This means that he or " "she is responsible for fixing bugs and answering problem reports pertaining " @@ -125,7 +125,7 @@ msgstr "" "обеспечением — за отслеживание новых версий, если это необходимо." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:84 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:83 msgid "" "Changes to directories which have a maintainer defined shall be sent to the " "maintainer for review before being committed. Only if the maintainer does " @@ -142,7 +142,7 @@ msgstr "" "изменений у кого-нибудь ещё." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:85 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:84 msgid "" "It is of course not acceptable to add a person or group as maintainer unless " "they agree to assume this duty. On the other hand it does not have to be a " @@ -154,13 +154,13 @@ msgstr "" "быть и группа людей." #. type: Title == -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:87 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:86 #, no-wrap msgid "Contributed Software" msgstr "Стороннее программное обеспечение" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:92 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:91 msgid "" "Some parts of the FreeBSD distribution consist of software that is actively " "being maintained outside the FreeBSD project. For historical reasons, we " @@ -173,7 +173,7 @@ msgstr "" "примеры: LLVM, man:zlib[3] и man:awk[1]." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:96 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:95 msgid "" "The accepted procedure for managing contributed software involves creating a " "_vendor branch_, where the software can be imported cleanly (without " @@ -191,7 +191,7 @@ msgstr "" "поставщика." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:100 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:99 msgid "" "Depending on their needs and complexity, individual software projects may " "deviate from this procedure, at the discretion of the maintainer. The exact " @@ -203,12 +203,12 @@ msgstr "" "В зависимости от потребностей и сложности, отдельные программные проекты " "могут отклоняться от этой процедуры по усмотрению сопровождающего. Точные " "шаги, необходимые для обновления конкретного программного обеспечения, " -"должны быть записаны в файле с именем `FREEBSD-upgrade`; например, " -"link:https://cgit.freebsd.org/src/tree/contrib/libarchive/FREEBSD-upgrade[" -"файл FREEBSD-upgrade libarchive]." +"должны быть записаны в файле с именем `FREEBSD-upgrade`; например, link:" +"https://cgit.freebsd.org/src/tree/contrib/libarchive/FREEBSD-upgrade[файл " +"FREEBSD-upgrade libarchive]." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:103 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:102 msgid "" "Contributed software is usually placed in the [.filepath]#contrib/# " "subdirectory of the source tree, with some exceptions. Contributed software " @@ -220,7 +220,7 @@ msgstr "" "filepath]#sys/contrib/#." #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:107 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:106 msgid "" "Because it makes it harder to import future versions minor, trivial and/or " "cosmetic changes are _strongly discouraged_ on files that are still tracking " @@ -231,30 +231,30 @@ msgstr "" "которые всё ещё отслеживают ветку поставщика." #. type: Title === -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:110 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:109 #, no-wrap msgid "Vendor Imports" msgstr "Импорт веток поставщика" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:113 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:112 msgid "" "The standard process for managing contributed software and vendor branches " "is described in detail by the extref:{committers-guide}#vendor-import-" "git[Committer's Guide]." msgstr "" "Стандартный процесс управления сторонним программным обеспечением и ветками " -"поставщиков подробно описан в extref:{committers-guide}#vendor-import-git[" -"Руководстве коммиттера]." +"поставщиков подробно описан в extref:{committers-guide}#vendor-import-" +"git[Руководстве коммиттера]." #. type: Title == -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:115 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:114 #, no-wrap msgid "Encumbered Files" msgstr "Файлы с правовыми ограничениями" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:121 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:120 msgid "" "It might occasionally be necessary to include an encumbered file in the " "FreeBSD source tree. For example, if a device requires a small piece of " @@ -264,14 +264,14 @@ msgid "" "the FreeBSD source tree." msgstr "" "Время от времени может возникнуть необходимость включить файл с правовыми " -"ограничениями (обремененными лицензиями, патентами) в дерево исходного кода " +"ограничениями (обременёнными лицензиями, патентами) в дерево исходного кода " "FreeBSD. Например, если устройство требует загрузки небольшого бинарного " "кода перед началом работы, а у нас нет исходного кода для него, то такой " -"бинарный файл считается обремененным. Следующие политики применяются к " -"включению обремененных файлов в дерево исходного кода FreeBSD." +"бинарный файл считается обременённым. Следующие политики применяются к " +"включению обременённых файлов в дерево исходного кода FreeBSD." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:123 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:122 msgid "" "Any file which is interpreted or executed by the system CPU(s) and not in " "source format is encumbered." @@ -280,44 +280,44 @@ msgstr "" "системы и не представлен в исходном формате, является обременённым." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:124 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:123 msgid "Any file with a license more restrictive than BSD or GNU is encumbered." msgstr "" "Любой файл с лицензией более ограничительной, чем BSD или GNU, является " "обременённым." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:125 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:124 msgid "" "A file which contains downloadable binary data for use by the hardware is " "not encumbered, unless (1) or (2) apply to it." msgstr "" "Файл, содержащий загружаемые двоичные данные для использования " -"оборудованием, не является обремененным, если к нему не применяется пункт (1)" -" или (2)." +"оборудованием, не является обременённым, если к нему не применяется пункт " +"(1) или (2)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:126 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:125 msgid "" "Any encumbered file requires specific approval from the link:https://www." "FreeBSD.org/administration/#t-core[Core Team] before it is added to the " "repository." msgstr "" -"Любой файл с правовыми ограничениями требует специального одобрения от " -"link:https://www.FreeBSD.org/administration/#t-core[Основной команды (Core " -"Team)] перед добавлением в репозиторий." +"Любой файл с правовыми ограничениями требует специального одобрения от link:" +"https://www.FreeBSD.org/administration/#t-core[Основной команды (Core Team)] " +"перед добавлением в репозиторий." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:127 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:126 msgid "" "Encumbered files go in [.filename]#src/contrib# or [.filename]#src/sys/" "contrib#." msgstr "" -"Обремененные файлы помещаются в [.filename]#src/contrib# или [.filename]#src/" +"Обременённые файлы помещаются в [.filename]#src/contrib# или [.filename]#src/" "sys/contrib#." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:128 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:127 msgid "" "The entire module should be kept together. There is no point in splitting " "it, unless there is code-sharing with non-encumbered code." @@ -326,7 +326,7 @@ msgstr "" "нет совместного использования кода с необременённой частью кода." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:130 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:129 msgid "" "In the past binary files were typically uuencoded, and named [." "filename]#arch/filename.o.uu#. This is no longer necessary, and binary " @@ -337,12 +337,12 @@ msgstr "" "файлы могут добавляться в репозиторий без изменений." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:131 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:130 msgid "Kernel files:" msgstr "Файлы ядра системы:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:132 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:131 msgid "" "Should always be referenced in [.filename]#conf/files.*# (for build " "simplicity)." @@ -351,7 +351,7 @@ msgstr "" "сборки)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:133 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:132 msgid "" "Should always be in [.filename]#LINT#, but the link:https://www.FreeBSD.org/" "administration/#t-core[Core Team] decides per case if it should be commented " @@ -365,17 +365,17 @@ msgstr "" "изменить свое решение." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:134 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:133 msgid "The _Release Engineer_ decides whether or not it goes into the release." msgstr "_Инженер по выпуску_ решает, будет ли это включено в выпуск." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:136 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:135 msgid "User-land files:" msgstr "Пользовательские файлы:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:137 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:136 msgid "" "The link:https://www.FreeBSD.org/administration/#t-core[Core team] decides " "if the code should be part of the installed base system." @@ -385,22 +385,22 @@ msgstr "" "систему." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:138 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:137 msgid "" "The link:https://www.FreeBSD.org/administration/#t-re[Release Engineering] " "decides if it goes into the release." msgstr "" -"link:https://www.FreeBSD.org/administration/#t-re[Команда подготовки релизов]" -" решает, будет ли это включено в релиз." +"link:https://www.FreeBSD.org/administration/#t-re[Команда подготовки " +"релизов] решает, будет ли это включено в релиз." #. type: Title == -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:140 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:139 #, no-wrap msgid "Shared Libraries" msgstr "Динамические библиотеки" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:144 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:143 msgid "" "If you are adding shared library support to a port or other piece of " "software that does not have one, the version numbers should follow these " @@ -413,41 +413,41 @@ msgstr "" "с версией выпуска программного обеспечения." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:146 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:145 msgid "For ports:" msgstr "Для портов:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:148 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:147 msgid "Prefer using the number already selected by upstream" msgstr "Предпочитайте использовать номер, уже выбранный вышестоящим проектом" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:149 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:148 msgid "If upstream provides symbol versioning, ensure that we use their script" msgstr "" "Если вышестоящий источник предоставляет управление версиями символов, " "убедитесь, что мы используем их скрипт" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:151 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:150 msgid "For the base system:" msgstr "Для базовой системы:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:153 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:152 msgid "Start library version from 1" msgstr "Начните версии библиотеки с 1" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:154 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:153 msgid "It is strongly recommended to add symbol versioning to the new library" msgstr "" "Настоятельно рекомендуется добавить контроль версий символов в новую " "библиотеку" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:155 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:154 msgid "" "If there is an incompatible change, handle it with symbol versioning, " "maintaining backward ABI compatibility" @@ -456,7 +456,7 @@ msgstr "" "символов, сохраняя обратную совместимость ABI" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:156 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:155 msgid "" "If this is impossible, or the library does not use symbol versioning, bump " "the library version" @@ -465,7 +465,7 @@ msgstr "" "увеличьте версию библиотеки" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:157 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:156 msgid "" "Before even considering bumping library version for symbol-versioned " "library, consult with Release Engineering team, providing reasons why the " @@ -477,7 +477,7 @@ msgstr "" "следует разрешить, несмотря на нарушение ABI" #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:159 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:158 msgid "" "For instance, added functions and bugfixes not changing the interfaces are " "fine, while deleted functions, changed function call syntax, etc. should " @@ -490,7 +490,7 @@ msgstr "" "приведут к изменению старшего номера версии." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:161 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:160 msgid "" "It is the duty of the committer making the change to handle library " "versioning." @@ -499,7 +499,7 @@ msgstr "" "библиотек." #. type: Plain text -#: documentation/content/en/books/developers-handbook/policies/_index.adoc:166 +#: documentation/content/en/books/developers-handbook/policies/_index.adoc:165 msgid "" "The ELF dynamic linker matches library names literally. There is a popular " "convention where library version is written in the form `libexample.so.x.y`, " @@ -517,8 +517,8 @@ msgstr "" "записывается в виде `libexample.so.x.y`, где x — это мажорная версия, а y — " "минорная. Общепринятой практикой является установка поля soname у библиотеки " "(тег ELF `DT_SONAME`) в `libexample.so.x`, а также создание символических " -"ссылок `libexample.so.x->libexample.so.x.y`, `libexample.so->libexample.so.x`" -" при установке библиотеки для последней минорной версии y. Таким образом, " +"ссылок `libexample.so.x->libexample.so.x.y`, `libexample.so->libexample.so." +"x` при установке библиотеки для последней минорной версии y. Таким образом, " "поскольку статический компоновщик ищет `libexample.so`, когда указана опция " "командной строки `-lexample`, объекты, скомпонованные с libexample, получают " "информацию о зависимости от правильной библиотеки. Почти все популярные " diff --git a/documentation/content/ru/books/developers-handbook/secure/_index.adoc b/documentation/content/ru/books/developers-handbook/secure/_index.adoc index 2ad0f536ae..6277fcdcd3 100644 --- a/documentation/content/ru/books/developers-handbook/secure/_index.adoc +++ b/documentation/content/ru/books/developers-handbook/secure/_index.adoc @@ -1,6 +1,6 @@ --- authors: - - + - author: 'Murray Stokely' description: 'Безопасное программирование в FreeBSD' next: books/developers-handbook/l10n @@ -78,37 +78,37 @@ endif::[] |=== |`strcpy`(char *dest, const char *src) -| +| Может переполнить буфер назначения |`strcat`(char *dest, const char *src) -| +| Может переполнить буфер назначения |`getwd`(char *buf) -| +| Может переполнить буфер buf |`gets`(char *s) -| +| Может переполнить буфер s |`[vf]scanf`(const char *format, ...) -| +| Может переполнить свои аргументы. |`realpath`(char *path, char resolved_path[]) -| +| Может переполнить буфер пути |`[v]sprintf`(char *str, const char *format, ...) -| +| Может переполнить буфер str. |=== diff --git a/documentation/content/ru/books/developers-handbook/secure/_index.po b/documentation/content/ru/books/developers-handbook/secure/_index.po index a79c5cf9d1..3cef67379a 100644 --- a/documentation/content/ru/books/developers-handbook/secure/_index.po +++ b/documentation/content/ru/books/developers-handbook/secure/_index.po @@ -5,7 +5,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2025-11-08 16:17+0000\n" +"POT-Creation-Date: 2026-08-06 22:55+0100\n" "PO-Revision-Date: 2025-11-25 04:45+0000\n" "Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n" "Language-Team: Russian <https://translate-dev.freebsd.org/projects/" @@ -14,8 +14,8 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && " -"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" +"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n" +"%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" "X-Generator: Weblate 4.17\n" #. type: YAML Front Matter: description @@ -37,13 +37,13 @@ msgid "Secure Programming" msgstr "Безопасное программирование" #. type: Title == -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:54 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:53 #, no-wrap msgid "Synopsis" msgstr "Обзор" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:57 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:56 msgid "" "This chapter describes some of the security issues that have plagued UNIX(R) " "programmers for decades and some of the new tools available to help " @@ -54,13 +54,13 @@ msgstr "" "помогающие избежать написания уязвимого кода." #. type: Title == -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:59 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:58 #, no-wrap msgid "Secure Design Methodology" msgstr "Методология безопасного проектирования" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:64 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:63 msgid "" "Writing secure applications takes a very scrutinous and pessimistic outlook " "on life. Applications should be run with the principle of \"least privilege" @@ -77,7 +77,7 @@ msgstr "" "распространённых ошибок, которые, возможно, уже исправили другие." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:68 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:67 msgid "" "One of the pitfalls of the UNIX(R) environment is how easy it is to make " "assumptions about the sanity of the environment. Applications should never " @@ -93,13 +93,13 @@ msgstr "" "атомарными." #. type: Title == -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:70 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:69 #, no-wrap msgid "Buffer Overflows" msgstr "Переполнение буфера" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:76 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:75 msgid "" "Buffer Overflows have been around since the very beginnings of the von " "Neumann crossref:bibliography[COD,1] architecture. They first gained " @@ -114,7 +114,7 @@ msgstr "" "переполнением буфера основан на повреждении стека." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:85 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:84 msgid "" "Most modern computer systems use a stack to pass arguments to procedures and " "to store local variables. A stack is a last in first out (LIFO) buffer in " @@ -142,15 +142,15 @@ msgstr "" "Поскольку это значение постоянно меняется по мере добавления новых значений " "на вершину стека, многие реализации также предоставляют \"указатель кадра\", " "который располагается вблизи начала стекового кадра, чтобы локальные " -"переменные могли легче адресоваться относительно этого значения. " -"crossref:bibliography[COD,1] Адрес возврата для вызовов функций также " -"хранится в стеке, и это является причиной эксплойтов переполнения стека, " -"поскольку переполнение локальной переменной в функции может перезаписать " -"адрес возврата этой функции, потенциально позволяя злоумышленнику выполнить " -"любой код по своему усмотрению." +"переменные могли легче адресоваться относительно этого значения. crossref:" +"bibliography[COD,1] Адрес возврата для вызовов функций также хранится в " +"стеке, и это является причиной эксплойтов переполнения стека, поскольку " +"переполнение локальной переменной в функции может перезаписать адрес " +"возврата этой функции, потенциально позволяя злоумышленнику выполнить любой " +"код по своему усмотрению." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:88 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:87 msgid "" "Although stack-based attacks are by far the most common, it would also be " "possible to overrun the stack with a heap-based (malloc/free) attack." @@ -159,7 +159,7 @@ msgstr "" "переполнение стека с помощью атаки на кучу (malloc/free)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:91 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:90 msgid "" "The C programming language does not perform automatic bounds checking on " "arrays or pointers as many other languages do. In addition, the standard C " @@ -170,92 +170,92 @@ msgstr "" "библиотека C содержит множество очень опасных функций." #. type: Table -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:97 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:96 #, no-wrap msgid "`strcpy`(char *dest, const char *src)" msgstr "`strcpy`(char *dest, const char *src)" #. type: Table -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:101 -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:106 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:100 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:105 #, no-wrap msgid "May overflow the dest buffer" msgstr "Может переполнить буфер назначения" #. type: Table -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:102 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:101 #, no-wrap msgid "`strcat`(char *dest, const char *src)" msgstr "`strcat`(char *dest, const char *src)" #. type: Table -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:107 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:106 #, no-wrap msgid "`getwd`(char *buf)" msgstr "`getwd`(char *buf)" #. type: Table -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:111 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:110 #, no-wrap msgid "May overflow the buf buffer" msgstr "Может переполнить буфер buf" #. type: Table -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:112 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:111 #, no-wrap msgid "`gets`(char *s)" msgstr "`gets`(char *s)" #. type: Table -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:116 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:115 #, no-wrap msgid "May overflow the s buffer" msgstr "Может переполнить буфер s" #. type: Table -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:117 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:116 #, no-wrap msgid "`[vf]scanf`(const char *format, ...)" msgstr "`[vf]scanf`(const char *format, ...)" #. type: Table -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:121 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:120 #, no-wrap msgid "May overflow its arguments." msgstr "Может переполнить свои аргументы." #. type: Table -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:122 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:121 #, no-wrap msgid "`realpath`(char *path, char resolved_path[])" msgstr "`realpath`(char *path, char resolved_path[])" #. type: Table -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:126 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:125 #, no-wrap msgid "May overflow the path buffer" msgstr "Может переполнить буфер пути" #. type: Table -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:127 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:126 #, no-wrap msgid "`[v]sprintf`(char *str, const char *format, ...)" msgstr "`[v]sprintf`(char *str, const char *format, ...)" #. type: Table -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:130 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:129 #, no-wrap msgid "May overflow the str buffer." msgstr "Может переполнить буфер str." #. type: Title === -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:132 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:131 #, no-wrap msgid "Example Buffer Overflow" msgstr "Пример переполнения буфера" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:135 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:134 msgid "" "The following example code contains a buffer overflow designed to overwrite " "the return address and skip the instruction immediately following the " @@ -266,13 +266,13 @@ msgstr "" "вызова функции. (Вдохновлено crossref:bibliography[Phrack,4])" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:139 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:138 #, no-wrap msgid "#include <stdio.h>\n" msgstr "#include <stdio.h>\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:144 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:143 #, no-wrap msgid "" "void manipulate(char *buffer) {\n" @@ -286,7 +286,7 @@ msgstr "" "}\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:148 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:147 #, no-wrap msgid "" "int main() {\n" @@ -298,13 +298,13 @@ msgstr "" " int i=0;\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:150 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:149 #, no-wrap msgid " while ((buffer[i++] = getchar()) != '\\n') {};\n" msgstr " while ((buffer[i++] = getchar()) != '\\n') {};\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:157 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:156 #, no-wrap msgid "" " i=1;\n" @@ -322,7 +322,7 @@ msgstr "" "}\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:160 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:159 msgid "" "Let us examine what the memory image of this process would look like if we " "were to input 160 spaces into our little program before hitting return." @@ -331,7 +331,7 @@ msgstr "" "введем 160 пробелов в нашу небольшую программу перед нажатием Enter." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:164 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:163 msgid "" "Obviously more malicious input can be devised to execute actual compiled " "instructions (such as exec(/bin/sh))." @@ -340,13 +340,13 @@ msgstr "" "выполнения реальных скомпилированных инструкций (например, exec(/bin/sh))." #. type: Title === -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:165 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:164 #, no-wrap msgid "Avoiding Buffer Overflows" msgstr "Избегание переполнения буфера" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:175 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:174 msgid "" "The most straightforward solution to the problem of stack-overflows is to " "always use length restricted memory and string copy functions. `strncpy` " @@ -377,7 +377,7 @@ msgstr "" "NUL." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:178 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:177 msgid "" "Another memory copy implementation exists to get around these problems. The " "`strlcpy` and `strlcat` functions guarantee that they will always null " @@ -388,13 +388,13 @@ msgstr "" "назначения нулевым символом при передаче аргумента ненулевой длины." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:179 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:178 #, no-wrap msgid "Compiler based run-time bounds checking" msgstr "Скомпилированная проверка границ во время выполнения" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:183 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:182 msgid "" "Unfortunately there is still a very large assortment of code in public use " "which blindly copies memory around without using any of the bounded copy " @@ -409,7 +409,7 @@ msgstr "" "выполнения, которая реализована в нескольких компиляторах C/C++." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:186 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:185 msgid "" "ProPolice is one such compiler feature, and is integrated into man:gcc[1] " "versions 4.1 and later. It replaces and extends the earlier StackGuard man:" @@ -420,7 +420,7 @@ msgstr "" "StackGuard для man:gcc[1]." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:190 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:189 msgid "" "ProPolice helps to protect against stack-based buffer overflows and other " "attacks by laying pseudo-random numbers in key areas of the stack before " @@ -441,7 +441,7 @@ msgstr "" "псевдослучайные канарейки нетронутыми." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:192 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:191 msgid "" "Recompiling your application with ProPolice is an effective means of " "stopping most buffer-overflow attacks, but it can still be compromised." @@ -451,13 +451,13 @@ msgstr "" "переполнением буфера, но оно всё ещё может быть скомпрометировано." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:193 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:192 #, no-wrap msgid "Library based run-time bounds checking" msgstr "Библиотечная проверка границ во время выполнения" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:197 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:196 msgid "" "Compiler-based mechanisms are completely useless for binary-only software " "for which you cannot recompile. For these situations there are a number of " @@ -473,22 +473,22 @@ msgstr "" "стека." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:199 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:198 msgid "libsafe" msgstr "libsafe" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:200 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:199 msgid "libverify" msgstr "libverify" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:201 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:200 msgid "libparanoia" msgstr "libparanoia" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:206 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:205 msgid "" "Unfortunately these library-based defenses have a number of shortcomings. " "These libraries only protect against a very small set of security related " @@ -505,13 +505,13 @@ msgstr "" "или сброшены пользователем." #. type: Title == -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:208 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:207 #, no-wrap msgid "SetUID issues" msgstr "Проблемы с SetUID" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:212 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:211 msgid "" "There are at least 6 different IDs associated with any given process, and " "you must therefore be very careful with the access that your process has at " @@ -525,7 +525,7 @@ msgstr "" "необходимости." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:215 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:214 msgid "" "The real user ID can only be changed by a superuser process. The login " "program sets this when a user initially logs in and it is seldom changed." @@ -535,7 +535,7 @@ msgstr "" "первоначальном входе пользователя в систему, и он редко изменяется." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:219 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:218 msgid "" "The effective user ID is set by the `exec()` functions if a program has its " "seteuid bit set. An application can call `seteuid()` at any time to set the " @@ -552,13 +552,13 @@ msgstr "" "ID." #. type: Title == -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:221 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:220 #, no-wrap msgid "Limiting your program's environment" msgstr "Ограничение окружения вашей программы" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:229 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:228 msgid "" "The traditional method of restricting a process is with the `chroot()` " "system call. This system call changes the root directory from which all " @@ -583,7 +583,7 @@ msgstr "" "другими творческими способами." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:234 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:233 msgid "" "The behavior of the `chroot()` system call can be controlled somewhat with " "the kern.chroot_allow_open_directories `sysctl` variable. When this value " @@ -602,13 +602,13 @@ msgstr "" "проверка на открытые каталоги будет полностью пропущена." #. type: Title === -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:235 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:234 #, no-wrap msgid "FreeBSD's jail functionality" msgstr "Функциональность клеток FreeBSD" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:239 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:238 msgid "" "The concept of a Jail extends upon the `chroot()` by limiting the powers of " "the superuser to create a true `virtual server'. Once a prison is set up " @@ -621,7 +621,7 @@ msgstr "" "указанный IP-адрес, а привилегии `root` внутри этой клетки сильно ограничены." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:243 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:242 msgid "" "While in a prison, any tests of superuser power within the kernel using the " "`suser()` call will fail. However, some calls to `suser()` have been " @@ -635,41 +635,41 @@ msgstr "" "процессов в клетке." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:245 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:244 msgid "A superuser process within a jailed environment has the power to:" msgstr "Суперпользователь в среде клетки имеет возможность:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:247 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:246 msgid "" "Manipulate credential with `setuid`, `seteuid`, `setgid`, `setegid`, " "`setgroups`, `setreuid`, `setregid`, `setlogin`" msgstr "" -"Управлять учётными данными с помощью `setuid`, `seteuid`, `setgid`, `setegid`" -", `setgroups`, `setreuid`, `setregid`, `setlogin`" +"Управлять учётными данными с помощью `setuid`, `seteuid`, `setgid`, " +"`setegid`, `setgroups`, `setreuid`, `setregid`, `setlogin`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:248 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:247 msgid "Set resource limits with `setrlimit`" msgstr "Устанавливать ограничений ресурсов с помощью `setrlimit`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:249 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:248 msgid "Modify some sysctl nodes (kern.hostname)" msgstr "Изменять некоторые узлы sysctl (kern.hostname)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:250 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:249 msgid "`chroot()`" msgstr "`chroot()`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:251 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:250 msgid "Set flags on a vnode: `chflags`, `fchflags`" msgstr "Устанавливать флаги на vnode: `chflags`, `fchflags`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:252 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:251 msgid "" "Set attributes of a vnode such as file permission, owner, group, size, " "access time, and modification time." @@ -678,13 +678,13 @@ msgstr "" "группа, размер, время доступа и время изменения." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:253 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:252 msgid "Bind to privileged ports in the Internet domain (ports < 1024)" msgstr "" "Привязываться к привилегированным портам в домене Интернета (порты < 1024)" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:257 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:256 msgid "" "`Jail` is a very useful tool for running applications in a secure " "environment but it does have some shortcomings. Currently, the IPC " @@ -701,13 +701,13 @@ msgstr "" "что означает «очень ограниченный»." #. type: Title === -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:258 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:257 #, no-wrap msgid "POSIX(R).1e Process Capabilities" msgstr "Возможности процесса в POSIX(R).1e" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:261 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:260 msgid "" "POSIX(R) has released a working draft that adds event auditing, access " "control lists, fine grained privileges, information labeling, and mandatory " @@ -718,7 +718,7 @@ msgstr "" "обязательный контроль доступа." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:264 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:263 msgid "" "This is a work in progress and is the focus of the http://www.trustedbsd.org/" "[TrustedBSD] project. Some of the initial work has been committed to " @@ -729,13 +729,13 @@ msgstr "" "добавлены в FreeBSD-CURRENT (cap_set_proc(3))." #. type: Title == -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:266 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:265 #, no-wrap msgid "Trust" msgstr "Доверие" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:270 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:269 msgid "" "An application should never assume that anything about the users environment " "is sane. This includes (but is certainly not limited to): user input, " @@ -749,7 +749,7 @@ msgstr "" "открытых файлов и т.д." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:275 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:274 msgid "" "You should never assume that you can catch all forms of invalid input that a " "user might supply. Instead, your application should use positive filtering " @@ -768,7 +768,7 @@ msgstr "" "символами оболочки." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:278 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:277 msgid "" "Perl has a really cool feature called \"Taint\" mode which can be used to " "prevent scripts from using data derived outside the program in an unsafe " @@ -784,13 +784,13 @@ msgstr "" "файлов." #. type: Title == -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:280 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:279 #, no-wrap msgid "Race Conditions" msgstr "Состояние гонки" #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:284 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:283 msgid "" "A race condition is anomalous behavior caused by the unexpected dependence " "on the relative timing of events. In other words, a programmer incorrectly " @@ -802,7 +802,7 @@ msgstr "" "другого." #. type: Plain text -#: documentation/content/en/books/developers-handbook/secure/_index.adoc:290 +#: documentation/content/en/books/developers-handbook/secure/_index.adoc:289 msgid "" "Some of the common causes of race conditions are signals, access checks, and " "file opens. Signals are asynchronous events by nature so special care must " diff --git a/documentation/content/ru/books/developers-handbook/sockets/_index.adoc b/documentation/content/ru/books/developers-handbook/sockets/_index.adoc index bb0c8db930..3a506bf3a3 100644 --- a/documentation/content/ru/books/developers-handbook/sockets/_index.adoc +++ b/documentation/content/ru/books/developers-handbook/sockets/_index.adoc @@ -100,7 +100,7 @@ image::layers.png[] В этот момент я слышу, как некоторые из вас кричат: _"Нет, это не так! Это формат файла!"_ -Ну что ж, конечно, это формат файла. Но с точки зрения передачи данных, формат файла — это протокол: структура файла — это _язык_, причем лаконичный, сообщающий нашему _процессу_, как организованы данные. Следовательно, это _протокол_. +Ну что ж, конечно, это формат файла. Но с точки зрения передачи данных, формат файла — это протокол: структура файла — это _язык_, причём лаконичный, сообщающий нашему _процессу_, как организованы данные. Следовательно, это _протокол_. Увы, если бы мы получили только PNG-файл, наше программное обеспечение столкнулось бы с серьёзной проблемой: как ему узнать, что данные представляют изображение, а не текст, звук или что-то ещё? Во-вторых, как ему определить, что изображение сохранено в формате PNG, а не GIF, JPEG или каком-либо другом формате изображений? @@ -188,7 +188,7 @@ int socket(int domain, int type, int protocol); Наконец, аргумент `protocol` зависит от двух предыдущих аргументов и не всегда имеет смысл. В таком случае используйте значение `0`. [NOTE] -.Неподключенный сокет +.Неподключённый сокет ==== Нигде в функции `socket` мы не указали, к какой другой системе должны быть подключены. Наш только что созданный сокет остаётся _неподключённым_. @@ -272,7 +272,7 @@ struct sockaddr { Используемый для IP — это AF_INET. Это символ для константы `2`. -Это _семейство адресов_, указанное в поле `sa_family` структуры `sockaddr`, определяет, как именно будут использоваться нечетко названные байты `sa_data`. +Это _семейство адресов_, указанное в поле `sa_family` структуры `sockaddr`, определяет, как именно будут использоваться нечётко названные байты `sa_data`. В частности, когда _семейство адресов_ — AF_INET, можно использовать `struct sockaddr_in` из [.filename]#netinet/in.h# везде, где ожидается `sockaddr`: @@ -905,4 +905,4 @@ image::serv2.png[] По этой причине _демону_ необходимо установить _обработчики сигналов_ на этапе _инициализации демона_. Как минимум, должен обрабатываться сигнал SIGCHLD, чтобы демон мог удалять зомби-процессы из системы и освобождать занимаемые ими системные ресурсы. -Вот почему наша блок-схема теперь содержит блок _обработки сигналов_, который не соединен с другими блоками. Кстати, многие серверы также обрабатывают SIGHUP и обычно интерпретируют его как сигнал от суперпользователя, указывающий на необходимость перечитать конфигурационные файлы. Это позволяет нам изменять настройки без необходимости завершать и перезапускать эти серверы. +Вот почему наша блок-схема теперь содержит блок _обработки сигналов_, который не соединён с другими блоками. Кстати, многие серверы также обрабатывают SIGHUP и обычно интерпретируют его как сигнал от суперпользователя, указывающий на необходимость перечитать конфигурационные файлы. Это позволяет нам изменять настройки без необходимости завершать и перезапускать эти серверы. diff --git a/documentation/content/ru/books/developers-handbook/sockets/_index.po b/documentation/content/ru/books/developers-handbook/sockets/_index.po index 52e372dc50..ef22315da9 100644 --- a/documentation/content/ru/books/developers-handbook/sockets/_index.po +++ b/documentation/content/ru/books/developers-handbook/sockets/_index.po @@ -5,8 +5,8 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2026-02-22 15:58+0000\n" -"PO-Revision-Date: 2026-03-04 20:01+0000\n" +"POT-Creation-Date: 2026-08-06 22:55+0100\n" +"PO-Revision-Date: 2026-05-18 04:45+0000\n" "Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n" "Language-Team: Russian <https://translate-dev.freebsd.org/projects/" "documentation/booksdevelopers-handbooksockets_index/ru/>\n" @@ -14,8 +14,8 @@ msgstr "" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && " -"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" +"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && n" +"%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" "X-Generator: Weblate 4.17\n" #. type: YAML Front Matter: description @@ -37,13 +37,13 @@ msgid "Sockets" msgstr "Сокеты" #. type: Title == -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:54 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:53 #, no-wrap msgid "Synopsis" msgstr "Обзор" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:59 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:58 msgid "" "BSD sockets take interprocess communications to a new level. It is no " "longer necessary for the communicating processes to run on the same " @@ -54,7 +54,7 @@ msgstr "" "машине. Они всё ещё _могут_, но не обязаны." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:62 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:61 msgid "" "Not only do these processes not have to run on the same machine, they do not " "have to run under the same operating system. Thanks to BSD sockets, your " @@ -71,7 +71,7 @@ msgstr "" "Ethernet." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:64 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:63 msgid "" "But your software can equally well cooperate with processes running in " "another building, or on another continent, inside a submarine, or a space " @@ -82,7 +82,7 @@ msgstr "" "подводной лодки или космического челнока." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:67 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:66 msgid "" "It can also cooperate with processes that are not part of a computer (at " "least not in the strict sense of the word), but of such devices as printers, " @@ -95,13 +95,13 @@ msgstr "" "Практически со всем, что способно к цифровой коммуникации." #. type: Title == -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:69 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:68 #, no-wrap msgid "Networking and Diversity" msgstr "Сетевое взаимодействие и разнообразие" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:75 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:74 msgid "" "We have already hinted on the _diversity_ of networking. Many different " "systems have to talk to each other. And they have to speak the same " @@ -112,7 +112,7 @@ msgstr "" "одном языке. Также они должны _понимать_ этот язык одинаковым образом." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:80 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:79 msgid "" "People often think that _body language_ is universal. But it is not. Back " "in my early teens, my father took me to Bulgaria. We were sitting at a " @@ -124,7 +124,7 @@ msgstr "" "когда к нам подошел продавец, предлагая купить жареный миндаль." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:83 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:82 msgid "" "I had not learned much Bulgarian by then, so, instead of saying no, I shook " "my head from side to side, the \"universal\" body language for _no_. The " @@ -135,7 +135,7 @@ msgstr "" "_нет_. Продавец тут же начал угощать нас миндалем." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:91 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:90 msgid "" "I then remembered I had been told that in Bulgaria shaking your head " "sideways meant _yes_. Quickly, I started nodding my head up and down. The " @@ -156,7 +156,7 @@ msgstr "" "продавец меня понял." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:95 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:94 msgid "" "It is the same with computers: The same symbols may have different, even " "outright opposite meaning. Therefore, for two computers to understand each " @@ -169,13 +169,13 @@ msgstr "" "одном _толковании_ языка." #. type: Title == -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:97 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:96 #, no-wrap msgid "Protocols" msgstr "Протоколы" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:104 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:103 msgid "" "While various programming languages tend to have complex syntax and use a " "number of multi-letter reserved words (which makes them easy for the human " @@ -194,7 +194,7 @@ msgstr "" "света, между двумя компьютерами они часто передаются значительно медленнее." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:106 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:105 msgid "" "As the languages used in data communications are so terse, we usually refer " "to them as _protocols_ rather than languages." @@ -203,7 +203,7 @@ msgstr "" "обычно называем их _протоколами_, а не языками." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:111 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:110 msgid "" "As data travels from one computer to another, it always uses more than one " "protocol. These protocols are _layered_. The data can be compared to the " @@ -216,19 +216,19 @@ msgstr "" "чтобы добраться до данных. Это лучше всего проиллюстрировано на рисунке:" #. type: Block title -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:112 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:111 #, no-wrap msgid "Protocol Layers" msgstr "Уровни протоколов" #. type: Target for macro image -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:113 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:112 #, no-wrap msgid "layers.png" msgstr "layers.png" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:116 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:115 msgid "" "In this example, we are trying to get an image from a web page we are " "connected to via an Ethernet." @@ -237,7 +237,7 @@ msgstr "" "подключены через Ethernet." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:119 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:118 msgid "" "The image consists of raw data, which is simply a sequence of RGB values " "that our software can process, i.e., convert into an image and display on " @@ -249,7 +249,7 @@ msgstr "" "мониторе." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:124 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:123 msgid "" "Alas, our software has no way of knowing how the raw data is organized: Is " "it a sequence of RGB values, or a sequence of grayscale intensities, or " @@ -265,12 +265,12 @@ msgstr "" "ли определённые пиксели быть прозрачными?" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:126 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:125 msgid "I think you get the picture..." msgstr "Я думаю, вы поняли..." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:129 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:128 msgid "" "To inform our software how to handle the raw data, it is encoded as a PNG " "file. It could be a GIF, or a JPEG, but it is a PNG." @@ -279,12 +279,12 @@ msgstr "" "они кодируются в формате PNG. Это мог бы быть GIF или JPEG, но выбран PNG." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:131 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:130 msgid "And PNG is a protocol." msgstr "И PNG — это протокол." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:133 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:132 msgid "" "At this point, I can hear some of you yelling, _\"No, it is not! It is a " "file format!\"_" @@ -293,7 +293,7 @@ msgstr "" "формат файла!\"_" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:138 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:137 msgid "" "Well, of course it is a file format. But from the perspective of data " "communications, a file format is a protocol: The file structure is a " @@ -301,12 +301,12 @@ msgid "" "is organized. Ergo, it is a _protocol_." msgstr "" "Ну что ж, конечно, это формат файла. Но с точки зрения передачи данных, " -"формат файла — это протокол: структура файла — это _язык_, причем " +"формат файла — это протокол: структура файла — это _язык_, причём " "лаконичный, сообщающий нашему _процессу_, как организованы данные. " "Следовательно, это _протокол_." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:141 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:140 msgid "" "Alas, if all we received was the PNG file, our software would be facing a " "serious problem: How is it supposed to know the data is representing an " @@ -321,7 +321,7 @@ msgstr "" "каком-либо другом формате изображений?" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:145 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:144 msgid "" "To obtain that information, we are using another protocol: HTTP. This " "protocol can tell us exactly that the data represents an image, and that it " @@ -334,7 +334,7 @@ msgstr "" "но давайте сосредоточимся на уровнях протоколов здесь." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:148 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:147 msgid "" "So, now we have some data wrapped in the PNG protocol, wrapped in the HTTP " "protocol. How did we get it from the server?" @@ -344,7 +344,7 @@ msgstr "" "сервера?" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:152 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:151 msgid "" "By using TCP/IP over Ethernet, that is how. Indeed, that is three more " "protocols. Instead of continuing inside out, I am now going to talk about " @@ -355,7 +355,7 @@ msgstr "" "про Ethernet, просто потому что так проще объяснить остальное." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:156 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:155 msgid "" "Ethernet is an interesting system of connecting computers in a _local area " "network_ (LAN). Each computer has a _network interface card_ (NIC), which " @@ -369,7 +369,7 @@ msgstr "" "одинаковым адресом." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:162 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:161 msgid "" "These NICs are all connected with each other. Whenever one computer wants " "to communicate with another in the same Ethernet LAN, it sends a message " @@ -386,7 +386,7 @@ msgstr "" "внимание, остальные проигнорируют его." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:166 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:165 msgid "" "But not all computers are connected to the same network. Just because we " "have received the data over our Ethernet does not mean it originated in our " @@ -400,7 +400,7 @@ msgstr "" "основе Ethernet), соединённой с нашей сетью через Интернет." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:170 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:169 msgid "" "All data is transferred over the Internet using IP, which stands for " "_Internet Protocol_. Its basic role is to let us know where in the world " @@ -415,7 +415,7 @@ msgstr "" "получим." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:173 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:172 msgid "" "Even if we do receive the data, IP does not guarantee we will receive " "various chunks of data in the same order the other computer has sent it to " @@ -428,7 +428,7 @@ msgstr "" "его верхний левый угол, а после — нижний правый." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:175 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:174 msgid "" "It is TCP (_Transmission Control Protocol_) that asks the sender to resend " "any lost data and that places it all into the proper order." @@ -437,7 +437,7 @@ msgstr "" "повторную отправку потерянных данных и располагает их в правильном порядке." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:178 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:177 msgid "" "All in all, it took _five_ different protocols for one computer to " "communicate to another what an image looks like. We received the data " @@ -452,7 +452,7 @@ msgstr "" "протокол Ethernet." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:182 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:181 msgid "" "Oh, and by the way, there probably were several other protocols involved " "somewhere on the way. For example, if our LAN was connected to the Internet " @@ -467,7 +467,7 @@ msgstr "" "и так далее, и так далее, и так далее..." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:184 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:183 msgid "" "As a developer you should be asking by now, _\"How am I supposed to handle " "it all?\"_" @@ -476,7 +476,7 @@ msgstr "" "этим справляться?\"_" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:189 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:188 msgid "" "Luckily for you, you are _not_ supposed to handle it all. You _are_ " "supposed to handle some of it, but not all of it. Specifically, you need " @@ -491,7 +491,7 @@ msgstr "" "TCP." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:192 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:191 msgid "" "In other words, you do not have to do anything to receive the data from the " "other computer. Well, you do have to _ask_ for it, but that is almost as " @@ -502,7 +502,7 @@ msgstr "" "открыть файл." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:195 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:194 msgid "" "Once you have received the data, it is up to you to figure out what to do " "with it. In our case, you would need to understand the HTTP protocol and " @@ -512,7 +512,7 @@ msgstr "" "потребуется понимание протокола HTTP и структуры файла PNG." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:199 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:198 msgid "" "To use an analogy, all the internetworking protocols become a gray area: Not " "so much because we do not understand how it works, but because we are no " @@ -525,19 +525,19 @@ msgstr "" "зоне:" #. type: Block title -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:200 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:199 #, no-wrap msgid "Sockets Covered Protocol Layers" msgstr "Уровни протоколов, покрываемые сокетами" #. type: Target for macro image -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:201 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:200 #, no-wrap msgid "slayers.png" msgstr "slayers.png" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:204 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:203 msgid "" "We only need to understand any protocols that tell us how to _interpret the " "data_, not how to _receive_ it from another process, nor how to _send_ it to " @@ -548,13 +548,13 @@ msgstr "" "как _передавать_ их другому процессу." #. type: Title == -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:206 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:205 #, no-wrap msgid "The Sockets Model" msgstr "Модель сокетов" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:211 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:210 msgid "" "BSD sockets are built on the basic UNIX(R) model: _Everything is a file._ In " "our example, then, sockets would let us receive an _HTTP file_, so to " @@ -565,7 +565,7 @@ msgstr "" "файл_. Затем нам предстоит извлечь из него _PNG-файл_." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:214 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:213 msgid "" "Due to the complexity of internetworking, we cannot just use the `open` " "system call, or the `open()` C function. Instead, we need to take several " @@ -576,7 +576,7 @@ msgstr "" "необходимо выполнить несколько шагов для \"открытия\" сокета." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:217 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:216 msgid "" "Once we do, however, we can start treating the _socket_ the same way we " "treat any _file descriptor_: We can `read` from it, `write` to it, `pipe` " @@ -588,13 +588,13 @@ msgstr "" "`закрывать` его." #. type: Title == -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:219 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:218 #, no-wrap msgid "Essential Socket Functions" msgstr "Основные функции сокетов" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:223 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:222 msgid "" "While FreeBSD offers different functions to work with sockets, we only " "_need_ four to \"open\" a socket. And in some cases we only need two." @@ -604,13 +604,13 @@ msgstr "" "случаях достаточно двух." #. type: Title === -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:225 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:224 #, no-wrap msgid "The Client-Server Difference" msgstr "Разница между клиентом и сервером" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:228 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:227 msgid "" "Typically, one of the ends of a socket-based data communication is a " "_server_, the other is a _client_." @@ -619,19 +619,19 @@ msgstr "" "_клиент_." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:230 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:229 #, no-wrap msgid "The Common Elements" msgstr "Общие элементы" #. type: Title ===== -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:233 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:232 #, no-wrap msgid "`socket`" msgstr "`socket`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:237 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:236 msgid "" "The one function used by both, clients and servers, is man:socket[2]. It is " "declared this way:" @@ -640,13 +640,13 @@ msgstr "" "объявляется следующим образом:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:241 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:240 #, no-wrap msgid "int socket(int domain, int type, int protocol);\n" msgstr "int socket(int domain, int type, int protocol);\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:246 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:245 msgid "" "The return value is of the same type as that of `open`, an integer. FreeBSD " "allocates its value from the same pool as that of file handles. That is " @@ -657,7 +657,7 @@ msgstr "" "позволяет обрабатывать сокеты так же, как файлы." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:250 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:249 msgid "" "The `domain` argument tells the system what _protocol family_ you want it to " "use. Many of them exist, some are vendor specific, others are very common. " @@ -669,13 +669,13 @@ msgstr "" "filename]#sys/socket.h#." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:252 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:251 msgid "Use `PF_INET` for UDP, TCP and other Internet protocols (IPv4)." msgstr "" "Используйте `PF_INET` для UDP, TCP и других интернет-протоколов (IPv4)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:256 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:255 msgid "" "Five values are defined for the `type` argument, again, in [.filename]#sys/" "socket.h#. All of them start with \"`SOCK_`\". The most common one is " @@ -689,7 +689,7 @@ msgstr "" "использовании с `PF_INET`)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:258 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:257 msgid "" "If you asked for `SOCK_DGRAM`, you would be requesting a _connectionless " "datagram delivery service_ (in our case, UDP)." @@ -698,7 +698,7 @@ msgstr "" "датаграмм без установления соединения_ (в нашем случае, UDP)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:260 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:259 msgid "" "If you wanted to be in charge of the low-level protocols (such as IP), or " "even network interfaces (e.g., the Ethernet), you would need to specify " @@ -709,7 +709,7 @@ msgstr "" "`SOCK_RAW`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:263 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:262 msgid "" "Finally, the `protocol` argument depends on the previous two arguments, and " "is not always meaningful. In that case, use `0` for its value." @@ -718,13 +718,13 @@ msgstr "" "всегда имеет смысл. В таком случае используйте значение `0`." #. type: Block title -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:265 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:264 #, no-wrap msgid "The Unconnected Socket" -msgstr "Неподключенный сокет" +msgstr "Неподключённый сокет" #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:269 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:268 msgid "" "Nowhere, in the `socket` function have we specified to what other system we " "should be connected. Our newly created socket remains _unconnected_." @@ -733,7 +733,7 @@ msgstr "" "подключены. Наш только что созданный сокет остаётся _неподключённым_." #. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:272 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:271 msgid "" "This is on purpose: To use a telephone analogy, we have just attached a " "modem to the phone line. We have neither told the modem to make a call, nor " @@ -744,13 +744,13 @@ msgstr "" "или ответить, если телефон зазвонит." #. type: Title ===== -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:275 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:274 #, no-wrap msgid "`sockaddr`" msgstr "`sockaddr`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:280 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:279 msgid "" "Various functions of the sockets family expect the address of (or pointer " "to, to use C terminology) a small area of the memory. The various C " @@ -763,7 +763,7 @@ msgstr "" "на `struct sockaddr`. Эта структура объявлена в том же файле:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:293 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:292 #, no-wrap msgid "" "/*\n" @@ -789,7 +789,7 @@ msgstr "" "#define\tSOCK_MAXADDRLEN\t255\t\t/* longest possible addresses */\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:297 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:296 msgid "" "Please note the _vagueness_ with which the `sa_data` field is declared, just " "as an array of `14` bytes, with the comment hinting there can be more than " @@ -800,7 +800,7 @@ msgstr "" "быть больше `14`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:300 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:299 msgid "" "This vagueness is quite deliberate. Sockets is a very powerful interface. " "While most people perhaps think of it as nothing more than the Internet " @@ -816,7 +816,7 @@ msgstr "" "точнее, IP) — лишь один из них." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:303 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:302 msgid "" "The [.filename]#sys/socket.h# refers to the various types of protocols " "sockets will handle as _address families_, and lists them right before the " @@ -827,7 +827,7 @@ msgstr "" "непосредственно перед определением `sockaddr`:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:352 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:351 #, no-wrap msgid "" "/*\n" @@ -925,22 +925,22 @@ msgstr "" "#define\tAF_MAX\t\t37\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:356 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:355 msgid "The one used for IP is AF_INET. It is a symbol for the constant `2`." msgstr "Используемый для IP — это AF_INET. Это символ для константы `2`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:358 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:357 msgid "" "It is the _address family_ listed in the `sa_family` field of `sockaddr` " "that decides how exactly the vaguely named bytes of `sa_data` will be used." msgstr "" "Это _семейство адресов_, указанное в поле `sa_family` структуры `sockaddr`, " -"определяет, как именно будут использоваться нечетко названные байты " +"определяет, как именно будут использоваться нечётко названные байты " "`sa_data`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:360 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:359 msgid "" "Specifically, whenever the _address family_ is AF_INET, we can use `struct " "sockaddr_in` found in [.filename]#netinet/in.h#, wherever `sockaddr` is " @@ -950,7 +950,7 @@ msgstr "" "sockaddr_in` из [.filename]#netinet/in.h# везде, где ожидается `sockaddr`:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:373 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:372 #, no-wrap msgid "" "/*\n" @@ -976,24 +976,24 @@ msgstr "" "};\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:376 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:375 msgid "We can visualize its organization this way:" msgstr "Мы можем визуализировать его организацию следующим образом:" #. type: Block title -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:377 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:376 #, no-wrap msgid "sockaddr_in structure" msgstr "Структура `sockaddr_in`" #. type: Target for macro image -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:378 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:377 #, no-wrap msgid "sain.png" msgstr "sain.png" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:381 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:380 msgid "" "The three important fields are `sin_family`, which is byte 1 of the " "structure, `sin_port`, a 16-bit value found in bytes 2 and 3, and " @@ -1005,7 +1005,7 @@ msgstr "" "32-битное целочисленное представление IP-адреса, хранящееся в байтах 4–7." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:387 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:386 msgid "" "Now, let us try to fill it out. Let us assume we are trying to write a " "client for the _daytime_ protocol, which simply states that its server will " @@ -1024,19 +1024,19 @@ msgstr "" "gov`)." #. type: Block title -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:388 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:387 #, no-wrap msgid "Specific example of sockaddr_in" msgstr "Конкретный пример sockaddr_in" #. type: Target for macro image -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:389 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:388 #, no-wrap msgid "sainfill.png" msgstr "sainfill.png" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:392 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:391 msgid "" "By the way the `sin_addr` field is declared as being of the `struct in_addr` " "type, which is defined in [.filename]#netinet/in.h#:" @@ -1045,7 +1045,7 @@ msgstr "" "определён в [.filename]#netinet/in.h#:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:401 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:400 #, no-wrap msgid "" "/*\n" @@ -1063,12 +1063,12 @@ msgstr "" "};\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:404 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:403 msgid "In addition, `in_addr_t` is a 32-bit integer." msgstr "В дополнение, `in_addr_t` является 32-битным целым числом." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:406 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:405 msgid "" "The `132.163.96.1` is just a convenient notation of expressing a 32-bit " "integer by listing all of its 8-bit bytes, starting with the _most " @@ -1078,7 +1078,7 @@ msgstr "" "которой перечисляются все его 8-битные байты, начиная с _старшего_." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:410 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:409 msgid "" "So far, we have viewed `sockaddr` as an abstraction. Our computer does not " "store `short` integers as a single 16-bit entity, but as a sequence of 2 " @@ -1090,12 +1090,12 @@ msgstr "" "последовательность 4 байт." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:412 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:411 msgid "Suppose we coded something like this:" msgstr "Предположим, мы написали что-то вроде этого:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:418 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:417 #, no-wrap msgid "" "sa.sin_family = AF_INET;\n" @@ -1107,12 +1107,12 @@ msgstr "" "sa.sin_addr.s_addr = (((((132 << 8) | 163) << 8) | 96) << 8) | 1;\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:421 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:420 msgid "What would the result look like?" msgstr "Как будет выглядеть результат?" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:424 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:423 msgid "" "Well, that depends, of course. On a Pentium(R), or other x86, based " "computer, it would look like this:" @@ -1121,38 +1121,38 @@ msgstr "" "или другим на базе x86 это будет выглядеть так:" #. type: Block title -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:425 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:424 #, no-wrap msgid "sockaddr_in on an Intel system" msgstr "`sockaddr_in` в системе с архитектурой Intel" #. type: Target for macro image -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:426 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:472 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:425 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:471 #, no-wrap msgid "sainlsb.png" msgstr "sainlsb.png" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:429 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:428 msgid "On a different system, it might look like this:" msgstr "На другой системе это может выглядеть так:" #. type: Block title -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:430 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:429 #, no-wrap msgid "sockaddr_in on an MSB system" msgstr "`sockaddr_in` в системе с порядком байтов от старшего к младшему" #. type: Target for macro image -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:431 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:477 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:430 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:476 #, no-wrap msgid "sainmsb.png" msgstr "sainmsb.png" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:435 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:434 msgid "" "And on a PDP it might look different yet. But the above two are the most " "common ways in use today." @@ -1161,7 +1161,7 @@ msgstr "" "являются наиболее распространёнными на сегодняшний день." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:439 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:438 msgid "" "Ordinarily, wanting to write portable code, programmers pretend that these " "differences do not exist. And they get away with it (except when they code " @@ -1174,12 +1174,12 @@ msgstr "" "отделаться не получится." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:441 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:440 msgid "Why?" msgstr "Почему?" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:443 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:442 msgid "" "Because when communicating with another computer, you usually do not know " "whether it stores data _most significant byte_ (MSB) or _least significant " @@ -1190,19 +1190,19 @@ msgstr "" "байта_ (LSB)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:445 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:444 msgid "You might be wondering, _\"So, will sockets not handle it for me?\"_" msgstr "" "Вы можете задаться вопросом: _\"Значит, сокеты не будут это делать за меня?" "\"_" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:447 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:446 msgid "It will not." msgstr "Не будут." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:450 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:449 msgid "" "While that answer may surprise you at first, remember that the general " "sockets interface only understands the `sa_len` and `sa_family` fields of " @@ -1219,7 +1219,7 @@ msgstr "" "является родным для компьютера)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:453 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:452 msgid "" "But the rest of the data is just `sa_data[14]` as far as sockets goes. " "Depending on the _address family_, sockets just forwards that data to its " @@ -1230,7 +1230,7 @@ msgstr "" "назначению." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:458 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:457 msgid "" "Indeed, when we enter a port number, it is because we want the other " "computer to know what service we are asking for. And, when we are the " @@ -1245,7 +1245,7 @@ msgstr "" "передать номер порта в качестве данных. Они никак его не интерпретируют." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:461 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:460 msgid "" "Similarly, we enter the IP address to tell everyone on the way where to send " "our data to. Sockets, again, only forwards it as data." @@ -1254,7 +1254,7 @@ msgstr "" "отправлять наши данные. Сокеты, опять же, просто пересылают их как данные." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:463 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:462 msgid "" "That is why, we (the _programmers_, not the _sockets_) have to distinguish " "between the byte order used by our computer and a conventional byte order to " @@ -1265,7 +1265,7 @@ msgstr "" "данных на другой компьютер." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:465 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:464 msgid "" "We will call the byte order our computer uses the _host byte order_, or just " "the _host order_." @@ -1274,7 +1274,7 @@ msgstr "" "_порядком байтов хоста_ или просто _хост-порядком_." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:468 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:467 msgid "" "There is a convention of sending the multi-byte data over IP _MSB first_. " "This, we will refer to as the _network byte order_, or simply the _network " @@ -1285,7 +1285,7 @@ msgstr "" "порядком_." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:470 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:469 msgid "" "Now, if we compiled the above code for an Intel based computer, our _host " "byte order_ would produce:" @@ -1294,33 +1294,33 @@ msgstr "" "Intel, наш _порядок байтов хоста_ выдал бы:" #. type: Block title -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:471 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:470 #, no-wrap msgid "Host byte order on an Intel system" msgstr "Порядок байтов на хосте в системе Intel" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:475 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:474 msgid "But the _network byte order_ requires that we store the data MSB first:" msgstr "" "Но порядок байтов в _сетевом формате_ требует, чтобы данные хранились " "начиная со старшего байта (MSB):" #. type: Block title -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:476 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:475 #, no-wrap msgid "Network byte order" msgstr "Порядок байтов в сети" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:480 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:479 msgid "" "Unfortunately, our _host order_ is the exact opposite of the _network order_." msgstr "" "К сожалению, наш _порядок хоста_ полностью противоположен _порядку сети_." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:483 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:482 msgid "" "We have several ways of dealing with it. One would be to _reverse_ the " "values in our code:" @@ -1329,7 +1329,7 @@ msgstr "" "_инвертировать_ значения в нашем коде:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:489 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:488 #, no-wrap msgid "" "sa.sin_family = AF_INET;\n" @@ -1341,7 +1341,7 @@ msgstr "" "sa.sin_addr.s_addr = (((((1 << 8) | 96) << 8) | 163) << 8) | 132;\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:494 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:493 msgid "" "This will _trick_ our compiler into storing the data in the _network byte " "order_. In some cases, this is exactly the way to do it (e.g., when " @@ -1354,7 +1354,7 @@ msgstr "" "это может вызвать проблему." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:498 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:497 msgid "" "Suppose, you wrote a sockets-based program in C. You know it is going to " "run on a Pentium(R), so you enter all your constants in reverse and force " @@ -1365,7 +1365,7 @@ msgstr "" "порядке и приводите их к _порядку байтов сети_. Она работает хорошо." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:503 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:502 msgid "" "Then, some day, your trusted old Pentium(R) becomes a rusty old Pentium(R). " "You replace it with a system whose _host order_ is the same as the _network " @@ -1379,7 +1379,7 @@ msgstr "" "кроме той одной программы, которую вы написали." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:507 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:506 msgid "" "You have since forgotten that you had forced all of your constants to the " "opposite of the _host order_. You spend some quality time tearing out your " @@ -1396,7 +1396,7 @@ msgstr "" "работать вообще." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:509 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:508 msgid "" "Eventually, you figure it out, say a couple of swear words, and start " "rewriting your code." @@ -1405,7 +1405,7 @@ msgstr "" "словечек и начинаете переписывать свой код." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:512 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:511 msgid "" "Luckily, you are not the first one to face the problem. Someone else has " "created the man:htons[3] and man:htonl[3] C functions to convert a `short` " @@ -1420,7 +1420,7 @@ msgstr "" "преобразования." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:515 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:514 msgid "" "On _MSB-first_ systems these functions do nothing. On _LSB-first_ systems " "they convert values to the proper order." @@ -1430,7 +1430,7 @@ msgstr "" "преобразуют значения в правильный порядок." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:517 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:516 msgid "" "So, regardless of what system your software is compiled on, your data will " "end up in the correct order if you use these functions." @@ -1440,13 +1440,13 @@ msgstr "" "функции." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:519 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:518 #, no-wrap msgid "Client Functions" msgstr "Функции клиента" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:524 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:523 msgid "" "Typically, the client initiates the connection to the server. The client " "knows which server it is about to call: It knows its IP address, and it " @@ -1461,13 +1461,13 @@ msgstr "" "специалистом по непонятным символам (_порт_)." #. type: Title ===== -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:526 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:525 #, no-wrap msgid "`connect`" msgstr "`connect`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:529 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:528 msgid "" "Once a client has created a socket, it needs to connect it to a specific " "port on a remote system. It uses man:connect[2]:" @@ -1476,13 +1476,13 @@ msgstr "" "порту на удалённой системе. Для этого используется man:connect[2]:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:533 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:532 #, no-wrap msgid "int connect(int s, const struct sockaddr *name, socklen_t namelen);\n" msgstr "int connect(int s, const struct sockaddr *name, socklen_t namelen);\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:538 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:537 msgid "" "The `s` argument is the socket, i.e., the value returned by the `socket` " "function. The `name` is a pointer to `sockaddr`, the structure we have " @@ -1495,7 +1495,7 @@ msgstr "" "нашей структуре `sockaddr`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:541 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:540 msgid "" "If `connect` is successful, it returns `0`. Otherwise it returns `-1` and " "stores the error code in `errno`." @@ -1504,7 +1504,7 @@ msgstr "" "возвращается `-1`, а код ошибки сохраняется в `errno`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:545 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:544 msgid "" "There are many reasons why `connect` may fail. For example, with an attempt " "to an Internet connection, the IP address may not exist, or it may be down, " @@ -1518,13 +1518,13 @@ msgstr "" "причинам." #. type: Title ===== -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:547 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:546 #, no-wrap msgid "Our First Client" msgstr "Наш первый клиент" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:550 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:549 msgid "" "We now know enough to write a very simple client, one that will get current " "time from `132.163.96.1` and print it to [.filename]#stdout#." @@ -1533,7 +1533,7 @@ msgstr "" "получит текущее время от `132.163.96.1` и выведет его в [.filename]#stdout#." #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:564 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:563 #, no-wrap msgid "" "/*\n" @@ -1561,7 +1561,7 @@ msgstr "" "#include <unistd.h>\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:569 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:568 #, no-wrap msgid "" "int main() {\n" @@ -1575,8 +1575,8 @@ msgstr "" " char buffer[BUFSIZ+1];\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:574 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:993 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:573 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:992 #, no-wrap msgid "" " if ((s = socket(PF_INET, SOCK_STREAM, 0)) < 0) {\n" @@ -1590,14 +1590,14 @@ msgstr "" " }\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:576 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:995 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:575 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:994 #, no-wrap msgid " memset(&sa, '\\0', sizeof(sa));\n" msgstr " memset(&sa, '\\0', sizeof(sa));\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:585 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:584 #, no-wrap msgid "" " sa.sin_family = AF_INET;\n" @@ -1619,7 +1619,7 @@ msgstr "" " }\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:588 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:587 #, no-wrap msgid "" " while ((bytes = read(s, buffer, BUFSIZ)) > 0)\n" @@ -1629,8 +1629,8 @@ msgstr "" " write(1, buffer, bytes);\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:592 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1019 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:591 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1018 #, no-wrap msgid "" " close(s);\n" @@ -1642,7 +1642,7 @@ msgstr "" "}\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:595 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:594 msgid "" "Go ahead, enter it in your editor, save it as [.filename]#daytime.c#, then " "compile and run it:" @@ -1651,7 +1651,7 @@ msgstr "" "затем скомпилируйте и запустите:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:600 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:599 #, no-wrap msgid "" "% cc -O3 -o daytime daytime.c\n" @@ -1661,7 +1661,7 @@ msgstr "" "% ./daytime\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:603 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:602 #, no-wrap msgid "" "52079 01-06-19 02:29:25 50 0 1 543.9 UTC(NIST) *\n" @@ -1671,7 +1671,7 @@ msgstr "" "%\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:607 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:606 msgid "" "In this case, the date was June 19, 2001, the time was 02:29:25 UTC. " "Naturally, your results will vary." @@ -1680,13 +1680,13 @@ msgstr "" "Естественно, ваши результаты могут отличаться." #. type: Title ==== -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:609 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:608 #, no-wrap msgid "Server Functions" msgstr "Функции сервера" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:615 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:614 msgid "" "The typical server does not initiate the connection. Instead, it waits for " "a client to call it and request services. It does not know when the client " @@ -1701,19 +1701,19 @@ msgstr "" "запросами от множества клиентов, обращающихся одновременно." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:617 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:616 msgid "The sockets interface offers three basic functions to handle this." msgstr "" "Интерфейс сокетов предоставляет три основные функции для обработки этого." #. type: Title ===== -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:619 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:618 #, no-wrap msgid "`bind`" msgstr "`bind`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:622 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:621 msgid "" "Ports are like extensions to a phone line: After you dial a number, you dial " "the extension to get to a specific person or department." @@ -1723,7 +1723,7 @@ msgstr "" "или отделом." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:626 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:625 msgid "" "There are 65535 IP ports, but a server usually processes requests that come " "in on only one of them. It is like telling the phone room operator that we " @@ -1737,13 +1737,13 @@ msgstr "" "каком порту мы хотим обслуживать запросы." #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:630 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:629 #, no-wrap msgid "int bind(int s, const struct sockaddr *addr, socklen_t addrlen);\n" msgstr "int bind(int s, const struct sockaddr *addr, socklen_t addrlen);\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:635 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:634 msgid "" "Beside specifying the port in `addr`, the server may include its IP " "address. However, it can just use the symbolic constant INADDR_ANY to " @@ -1758,13 +1758,13 @@ msgstr "" "filename]#netinet/in.h#" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:639 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:638 #, no-wrap msgid "#define\tINADDR_ANY\t\t(u_int32_t)0x00000000\n" msgstr "#define\tINADDR_ANY\t\t(u_int32_t)0x00000000\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:644 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:643 msgid "" "Suppose we were writing a server for the _daytime_ protocol over TCP/IP. " "Recall that it uses port 13. Our `sockaddr_in` structure would look like " @@ -1775,25 +1775,25 @@ msgstr "" "выглядеть так:" #. type: Block title -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:645 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:644 #, no-wrap msgid "Example Server sockaddr_in" msgstr "Пример sockaddr_in сервера" #. type: Target for macro image -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:646 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:645 #, no-wrap msgid "sainserv.png" msgstr "sainserv.png" #. type: Title ===== -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:649 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:648 #, no-wrap msgid "`listen`" msgstr "`listen`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:653 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:652 msgid "" "To continue our office phone analogy, after you have told the phone central " "operator what extension you will be at, you now walk into your office, and " @@ -1808,18 +1808,18 @@ msgstr "" "разговора с кем-то." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:655 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:654 msgid "The server ensures all of that with the man:listen[2] function." msgstr "Сервер обеспечивает все это с помощью функции man:listen[2]." #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:659 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:658 #, no-wrap msgid "int listen(int s, int backlog);\n" msgstr "int listen(int s, int backlog);\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:663 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:662 msgid "" "In here, the `backlog` variable tells sockets how many incoming requests to " "accept while you are busy processing the last request. In other words, it " @@ -1830,13 +1830,13 @@ msgstr "" "она определяет максимальный размер очереди ожидающих соединений." #. type: Title ===== -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:665 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:664 #, no-wrap msgid "`accept`" msgstr "`accept`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:670 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:669 msgid "" "After you hear the phone ringing, you accept the call by answering the " "call. You have now established a connection with your client. This " @@ -1847,18 +1847,18 @@ msgstr "" "остаётся активным, пока вы или ваш клиент не повесите трубку." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:672 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:671 msgid "The server accepts the connection by using the man:accept[2] function." msgstr "Сервер принимает соединение, используя функцию man:accept[2]." #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:676 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:675 #, no-wrap msgid "int accept(int s, struct sockaddr *addr, socklen_t *addrlen);\n" msgstr "int accept(int s, struct sockaddr *addr, socklen_t *addrlen);\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:680 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:679 msgid "" "Note that this time `addrlen` is a pointer. This is necessary because in " "this case it is the socket that fills out `addr`, the `sockaddr_in` " @@ -1869,7 +1869,7 @@ msgstr "" "`addr` — `sockaddr_in`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:684 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:683 msgid "" "The return value is an integer. Indeed, the `accept` returns a _new " "socket_. You will use this new socket to communicate with the client." @@ -1879,7 +1879,7 @@ msgstr "" "данными с клиентом." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:686 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:685 msgid "" "What happens to the old socket? It continues to listen for more requests " "(remember the `backlog` variable we passed to `listen`?) until we `close` it." @@ -1889,7 +1889,7 @@ msgstr "" "закроем его (`close`)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:690 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:689 msgid "" "Now, the new socket is meant only for communications. It is fully " "connected. We cannot pass it to `listen` again, trying to accept additional " @@ -1900,13 +1900,13 @@ msgstr "" "дополнительные соединения." #. type: Title ===== -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:692 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:691 #, no-wrap msgid "Our First Server" msgstr "Наш первый сервер" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:696 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:695 msgid "" "Our first server will be somewhat more complex than our first client was: " "Not only do we have more sockets functions to use, but we need to write it " @@ -1916,7 +1916,7 @@ msgstr "" "только использовать больше функций сокетов, но и написать его как демон." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:699 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:698 msgid "" "This is best achieved by creating a _child process_ after binding the port. " "The main process then exits and returns control to the shell (or whatever " @@ -1927,7 +1927,7 @@ msgstr "" "(или любой другой программе, которая его вызвала)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:701 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:700 msgid "" "The child calls `listen`, then starts an endless loop, which accepts a " "connection, serves it, and eventually closes its socket." @@ -1937,7 +1937,7 @@ msgstr "" "свой сокет." #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:717 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:716 #, no-wrap msgid "" "/*\n" @@ -1969,13 +1969,13 @@ msgstr "" "#include <netinet/in.h>\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:719 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:718 #, no-wrap msgid "#define BACKLOG 4\n" msgstr "#define BACKLOG 4\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:727 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:726 #, no-wrap msgid "" "int main() {\n" @@ -1995,7 +1995,7 @@ msgstr "" " FILE *client;\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:732 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:731 #, no-wrap msgid "" " if ((s = socket(PF_INET, SOCK_STREAM, 0)) < 0) {\n" @@ -2009,13 +2009,13 @@ msgstr "" " }\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:734 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:733 #, no-wrap msgid " memset(&sa, '\\0', sizeof(sa));\n" msgstr " memset(&sa, '\\0', sizeof(sa));\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:737 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:736 #, no-wrap msgid "" " sa.sin_family = AF_INET;\n" @@ -2025,7 +2025,7 @@ msgstr "" " sa.sin_port = htons(13);\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:740 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:739 #, no-wrap msgid "" " if (INADDR_ANY)\n" @@ -2035,7 +2035,7 @@ msgstr "" " sa.sin_addr.s_addr = htonl(INADDR_ANY);\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:745 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:744 #, no-wrap msgid "" " if (bind(s, (struct sockaddr *)&sa, sizeof sa) < 0) {\n" @@ -2049,7 +2049,7 @@ msgstr "" " }\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:756 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:755 #, no-wrap msgid "" " switch (fork()) {\n" @@ -2075,13 +2075,13 @@ msgstr "" " }\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:758 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:757 #, no-wrap msgid " listen(s, BACKLOG);\n" msgstr " listen(s, BACKLOG);\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:761 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:760 #, no-wrap msgid "" " for (;;) {\n" @@ -2091,7 +2091,7 @@ msgstr "" " b = sizeof sa;\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:766 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:765 #, no-wrap msgid "" " if ((c = accept(s, (struct sockaddr *)&sa, &b)) < 0) {\n" @@ -2105,7 +2105,7 @@ msgstr "" " }\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:771 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:770 #, no-wrap msgid "" " if ((client = fdopen(c, \"w\")) == NULL) {\n" @@ -2119,7 +2119,7 @@ msgstr "" " }\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:776 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:775 #, no-wrap msgid "" " if ((t = time(NULL)) < 0) {\n" @@ -2133,7 +2133,7 @@ msgstr "" " }\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:785 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:784 #, no-wrap msgid "" " tm = gmtime(&t);\n" @@ -2155,7 +2155,7 @@ msgstr "" " tm->tm_sec);\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:789 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:788 #, no-wrap msgid "" " fclose(client);\n" @@ -2167,7 +2167,7 @@ msgstr "" "}\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:794 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:793 msgid "" "We start by creating a socket. Then we fill out the `sockaddr_in` structure " "in `sa`. Note the conditional use of INADDR_ANY:" @@ -2176,7 +2176,7 @@ msgstr "" "Обратите внимание на условное использование INADDR_ANY:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:799 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:798 #, no-wrap msgid "" "if (INADDR_ANY)\n" @@ -2186,7 +2186,7 @@ msgstr "" " sa.sin_addr.s_addr = htonl(INADDR_ANY);\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:806 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:805 msgid "" "Its value is `0`. Since we have just used `memset` to set zeroes on the " "entire structure, it would be redundant to set it to `0` again. But if we " @@ -2204,7 +2204,7 @@ msgstr "" "условное выражение из кода." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:810 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:809 msgid "" "After we have called `bind` successfully, we are ready to become a _daemon_: " "We use `fork` to create a child process. In both, the parent and the child, " @@ -2219,7 +2219,7 @@ msgstr "" "своему родителю об успешном завершении." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:815 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:814 msgid "" "Meanwhile, the child process continues working in the background. It calls " "`listen` and sets its backlog to `4`. It does not need a large value here " @@ -2233,7 +2233,7 @@ msgstr "" "мгновенно обрабатывать каждый запрос." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:817 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:816 msgid "" "Finally, the daemon starts an endless loop, which performs the following " "steps:" @@ -2241,7 +2241,7 @@ msgstr "" "Наконец, демон запускает бесконечный цикл, который выполняет следующие шаги:" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:820 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:819 msgid "" "Call `accept`. It waits here until a client contacts it. At that point, it " "receives a new socket, `c`, which it can use to communicate with this " @@ -2252,7 +2252,7 @@ msgstr "" "данными с этим конкретным клиентом." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:821 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:820 msgid "" "It uses the C function `fdopen` to turn the socket from a low-level _file " "descriptor_ to a C-style `FILE` pointer. This will allow the use of " @@ -2263,7 +2263,7 @@ msgstr "" "позволит в дальнейшем использовать `fprintf`." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:822 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:821 msgid "" "It checks the time, and prints it in the _ISO 8601_ format to the `client` " "\"file\". It then uses `fclose` to close the file. That will automatically " @@ -2274,26 +2274,26 @@ msgstr "" "закроет сокет." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:824 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:823 msgid "We can _generalize_ this, and use it as a model for many other servers:" msgstr "" "Мы можем _обобщить_ это и использовать в качестве модели для многих других " "серверов:" #. type: Block title -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:825 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:824 #, no-wrap msgid "Sequential Server" msgstr "Последовательный Сервер" #. type: Target for macro image -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:826 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:825 #, no-wrap msgid "serv.png" msgstr "serv.png" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:832 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:831 msgid "" "This flowchart is good for _sequential servers_, i.e., servers that can " "serve one client at a time, just as we were able to with our _daytime_ " @@ -2310,7 +2310,7 @@ msgstr "" "соединение. Вся операция может занять наносекунды, и она завершена." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:835 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:834 msgid "" "The advantage of this flowchart is that, except for the brief moment after " "the parent ``fork``s and before it exits, there is always only one _process_ " @@ -2322,7 +2322,7 @@ msgstr "" "других системных ресурсов." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:839 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:838 msgid "" "Note that we have added _initialize daemon_ in our flowchart. We did not " "need to initialize our own daemon, but this is a good place in the flow of " @@ -2334,7 +2334,7 @@ msgstr "" "открытия необходимых файлов и т. д." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:843 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:842 msgid "" "Just about everything in the flow chart can be used literally on many " "different servers. The _serve_ entry is the exception. We think of it as a " @@ -2347,7 +2347,7 @@ msgstr "" "своего сервера и просто \"подключаете к остальной системе.\"" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:849 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:848 msgid "" "Not all protocols are that simple. Many receive a request from the client, " "reply to it, then receive another request from the same client. As a " @@ -2364,7 +2364,7 @@ msgstr "" "новые подключения." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:852 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:851 msgid "" "Now, go ahead, save the above source code as [.filename]#daytimed.c# (it is " "customary to end the names of daemons with the letter `d`). After you have " @@ -2375,7 +2375,7 @@ msgstr "" "запустить его:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:858 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:857 #, no-wrap msgid "" "% ./daytimed\n" @@ -2387,7 +2387,7 @@ msgstr "" "%\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:862 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:861 msgid "" "What happened here? As you will recall, the _daytime_ protocol uses port " "13. But all ports below 1024 are reserved to the superuser (otherwise, " @@ -2400,12 +2400,12 @@ msgstr "" "используемый порт, создавая угрозу безопасности)." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:864 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:863 msgid "Try again, this time as the superuser:" msgstr "Попробуйте снова, на этот раз как суперпользователь:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:869 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:868 #, no-wrap msgid "" "# ./daytimed\n" @@ -2415,18 +2415,18 @@ msgstr "" "#\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:872 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:871 msgid "What... Nothing? Let us try again:" msgstr "Что... Ничего? Давайте попробуем ещё раз:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:876 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:875 #, no-wrap msgid "# ./daytimed\n" msgstr "# ./daytimed\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:879 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:878 #, no-wrap msgid "" "bind: Address already in use\n" @@ -2436,7 +2436,7 @@ msgstr "" "#\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:884 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:883 msgid "" "Every port can only be bound by one program at a time. Our first attempt " "was indeed successful: It started the child daemon and returned quietly. It " @@ -2450,7 +2450,7 @@ msgstr "" "вызовов не завершится с ошибкой или пока вы не перезагрузите систему." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:887 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:886 msgid "" "Fine, we know it is running in the background. But is it working? How do we " "know it is a proper _daytime_ server? Simple:" @@ -2459,13 +2459,13 @@ msgstr "" "мы можем убедиться, что это настоящий сервер _daytime_? Просто:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:891 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:890 #, no-wrap msgid "% telnet localhost 13\n" msgstr "% telnet localhost 13\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:900 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:899 #, no-wrap msgid "" "Trying ::1...\n" @@ -2487,7 +2487,7 @@ msgstr "" "%\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:905 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:904 msgid "" "telnet tried the new IPv6, and failed. It retried with IPv4 and succeeded. " "The daemon works." @@ -2496,7 +2496,7 @@ msgstr "" "попытку с IPv4, и это удалось. Демон работает." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:908 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:907 msgid "" "If you have access to another UNIX(R) system via telnet, you can use it to " "test accessing the server remotely. My computer does not have a static IP " @@ -2507,13 +2507,13 @@ msgstr "" "имеет статического IP-адреса, поэтому я сделал следующее:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:912 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:911 #, no-wrap msgid "% who\n" msgstr "% who\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:916 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:915 #, no-wrap msgid "" "whizkid ttyp0 Jun 19 16:59 (216.127.220.143)\n" @@ -2525,7 +2525,7 @@ msgstr "" "% telnet 216.127.220.143 13\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:923 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:922 #, no-wrap msgid "" "Trying 216.127.220.143...\n" @@ -2543,19 +2543,19 @@ msgstr "" "%\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:926 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:925 msgid "Again, it worked. Will it work using the domain name?" msgstr "" "Снова, это сработало. Сработает ли это с использованием доменного имени?" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:930 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:929 #, no-wrap msgid "% telnet r47.bfm.org 13\n" msgstr "% telnet r47.bfm.org 13\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:937 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:936 #, no-wrap msgid "" "Trying 216.127.220.143...\n" @@ -2573,7 +2573,7 @@ msgstr "" "%\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:941 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:940 msgid "" "By the way, telnet prints the _Connection closed by foreign host_ message " "after our daemon has closed the socket. This shows us that, indeed, using " @@ -2584,13 +2584,13 @@ msgstr "" "`fclose(client);` в нашем коде действительно работает, как заявлено." #. type: Title == -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:943 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:942 #, no-wrap msgid "Helper Functions" msgstr "Вспомогательные функции" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:949 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:948 msgid "" "FreeBSD C library contains many helper functions for sockets programming. " "For example, in our sample client we hard coded the `time.nist.gov` IP " @@ -2605,13 +2605,13 @@ msgstr "" "пользователю ввести IP-адрес или даже доменное имя." #. type: Title === -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:951 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:950 #, no-wrap msgid "`gethostbyname`" msgstr "`gethostbyname`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:954 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:953 msgid "" "While there is no way to pass the domain name directly to any of the sockets " "functions, the FreeBSD C library comes with the man:gethostbyname[3] and man:" @@ -2622,7 +2622,7 @@ msgstr "" "gethostbyname[3] и man:gethostbyname2[3], объявленные в [.filename]#netdb.h#." #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:959 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:958 #, no-wrap msgid "" "struct hostent * gethostbyname(const char *name);\n" @@ -2632,7 +2632,7 @@ msgstr "" "struct hostent * gethostbyname2(const char *name, int af);\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:963 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:962 msgid "" "Both return a pointer to the `hostent` structure, with much information " "about the domain. For our purposes, the `h_addr_list[0]` field of the " @@ -2645,7 +2645,7 @@ msgstr "" "сети_." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:965 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:964 msgid "" "This allows us to create a much more flexible-and much more useful-version " "of our daytime program:" @@ -2654,7 +2654,7 @@ msgstr "" "версию нашей программы daytime:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:981 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:980 #, no-wrap msgid "" "/*\n" @@ -2686,7 +2686,7 @@ msgstr "" "#include <netdb.h>\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:988 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:987 #, no-wrap msgid "" "int main(int argc, char *argv[]) {\n" @@ -2704,7 +2704,7 @@ msgstr "" " char *host;\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:998 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:997 #, no-wrap msgid "" " sa.sin_family = AF_INET;\n" @@ -2714,13 +2714,13 @@ msgstr "" " sa.sin_port = htons(13);\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1000 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:999 #, no-wrap msgid " host = (argc > 1) ? argv[1] : \"time.nist.gov\";\n" msgstr " host = (argc > 1) ? argv[1] : \"time.nist.gov\";\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1005 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1004 #, no-wrap msgid "" " if ((he = gethostbyname(host)) == NULL) {\n" @@ -2734,13 +2734,13 @@ msgstr "" " }\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1007 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1006 #, no-wrap msgid " memcpy(&sa.sin_addr, he->h_addr_list[0], he->h_length);\n" msgstr " memcpy(&sa.sin_addr, he->h_addr_list[0], he->h_length);\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1012 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1011 #, no-wrap msgid "" " if (connect(s, (struct sockaddr *)&sa, sizeof sa) < 0) {\n" @@ -2754,7 +2754,7 @@ msgstr "" " }\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1015 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1014 #, no-wrap msgid "" " while ((bytes = read(s, buf, BUFSIZ)) > 0)\n" @@ -2764,7 +2764,7 @@ msgstr "" " write(1, buf, bytes);\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1025 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1024 msgid "" "We now can type a domain name (or an IP address, it works both ways) on the " "command line, and the program will try to connect to its _daytime_ server. " @@ -2775,13 +2775,13 @@ msgid "" msgstr "" "Теперь мы можем ввести доменное имя (или IP-адрес, это работает в обоих " "направлениях) в командной строке, и программа попытается подключиться к его " -"серверу _daytime_. В противном случае по умолчанию будет использоваться `time" -".nist.gov`. Однако даже в этом случае мы будем использовать `gethostbyname` " -"вместо жёсткого указания `132.163.96.1`. Таким образом, даже если его IP-" -"адрес изменится в будущем, мы всё равно сможем его найти." +"серверу _daytime_. В противном случае по умолчанию будет использоваться " +"`time.nist.gov`. Однако даже в этом случае мы будем использовать " +"`gethostbyname` вместо жёсткого указания `132.163.96.1`. Таким образом, даже " +"если его IP-адрес изменится в будущем, мы всё равно сможем его найти." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1029 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1028 msgid "" "Since it takes virtually no time to get the time from your local server, you " "could run daytime twice in a row: First to get the time from `time.nist." @@ -2795,13 +2795,13 @@ msgstr "" "вашей системы:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1033 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1032 #, no-wrap msgid "% daytime ; daytime localhost\n" msgstr "% daytime ; daytime localhost\n" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1037 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1036 #, no-wrap msgid "" "52080 01-06-20 04:02:33 50 0 0 390.2 UTC(NIST) *\n" @@ -2813,18 +2813,18 @@ msgstr "" "%\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1040 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1039 msgid "As you can see, my system was two seconds ahead of the NIST time." msgstr "Как видно, моя система опережала время NIST на две секунды." #. type: Title === -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1042 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1041 #, no-wrap msgid "`getservbyname`" msgstr "`getservbyname`" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1046 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1045 msgid "" "Sometimes you may not be sure what port a certain service uses. The man:" "getservbyname[3] function, also declared in [.filename]#netdb.h# comes in " @@ -2835,13 +2835,13 @@ msgstr "" "объявленная в [.filename]#netdb.h#:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1050 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1049 #, no-wrap msgid "struct servent * getservbyname(const char *name, const char *proto);\n" msgstr "struct servent * getservbyname(const char *name, const char *proto);\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1053 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1052 msgid "" "The `servent` structure contains the `s_port`, which contains the proper " "port, already in _network byte order_." @@ -2850,7 +2850,7 @@ msgstr "" "порт, уже в _порядке байтов сети_." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1055 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1054 msgid "" "Had we not known the correct port for the _daytime_ service, we could have " "found it this way:" @@ -2859,7 +2859,7 @@ msgstr "" "его следующим образом:" #. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1065 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1064 #, no-wrap msgid "" "struct servent *se;\n" @@ -2879,7 +2879,7 @@ msgstr "" " sa.sin_port = se->s_port;\n" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1072 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1071 msgid "" "You usually do know the port. But if you are developing a new protocol, you " "may be testing it on an unofficial port. Some day, you will register the " @@ -2898,13 +2898,13 @@ msgstr "" "найдёт его порт без необходимости переписывать код." #. type: Title == -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1074 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1073 #, no-wrap msgid "Concurrent Servers" msgstr "Многозадачные серверы" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1078 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1077 msgid "" "Unlike a sequential server, a _concurrent server_ has to be able to serve " "more than one client at a time. For example, a _chat server_ may be serving " @@ -2917,24 +2917,24 @@ msgstr "" "закончит обслуживать текущего клиента, прежде чем перейти к следующему." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1080 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1079 msgid "This requires a significant change in our flowchart:" msgstr "Это требует значительных изменений в нашей блок-схеме:" #. type: Block title -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1081 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1080 #, no-wrap msgid "Concurrent Server" msgstr "Многозадачный сервер" #. type: Target for macro image -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1082 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1081 #, no-wrap msgid "serv2.png" msgstr "serv2.png" #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1086 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1085 msgid "" "We moved the _serve_ from the _daemon process_ to its own _server process_. " "However, because each child process inherits all open files (and a socket is " @@ -2950,7 +2950,7 @@ msgstr "" "начале." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1089 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1088 msgid "" "However, the _server process_ does not need this socket and should `close` " "it immediately. Similarly, the _daemon process_ no longer needs the " @@ -2964,7 +2964,7 @@ msgstr "" "дескрипторы_." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1092 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1091 msgid "" "After the _server process_ is done serving, it should close the _accepted " "socket_. Instead of returning to `accept`, it now exits." @@ -2973,7 +2973,7 @@ msgstr "" "_принятый сокет_. Вместо возврата к `accept`, процесс теперь завершается." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1099 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1098 msgid "" "Under UNIX(R), a process does not really _exit_. Instead, it _returns_ to " "its parent. Typically, a parent process ``wait``s for its child process, " @@ -2991,7 +2991,7 @@ msgstr "" "функционирующими, но всё ещё бродящими вокруг." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1102 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1101 msgid "" "For that reason, the _daemon process_ needs to set _signal handlers_ in its " "_initialize daemon_ phase. At least a SIGCHLD signal has to be processed, " @@ -3004,7 +3004,7 @@ msgstr "" "занимаемые ими системные ресурсы." #. type: Plain text -#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1105 +#: documentation/content/en/books/developers-handbook/sockets/_index.adoc:1104 msgid "" "That is why our flowchart now contains a _process signals_ box, which is not " "connected to any other box. By the way, many servers also process SIGHUP, " @@ -3013,7 +3013,7 @@ msgid "" "having to kill and restart these servers." msgstr "" "Вот почему наша блок-схема теперь содержит блок _обработки сигналов_, " -"который не соединен с другими блоками. Кстати, многие серверы также " +"который не соединён с другими блоками. Кстати, многие серверы также " "обрабатывают SIGHUP и обычно интерпретируют его как сигнал от " "суперпользователя, указывающий на необходимость перечитать конфигурационные " "файлы. Это позволяет нам изменять настройки без необходимости завершать и " diff --git a/documentation/content/ru/books/developers-handbook/x86/_index.po b/documentation/content/ru/books/developers-handbook/x86/_index.po deleted file mode 100644 index 0c5f408fda..0000000000 --- a/documentation/content/ru/books/developers-handbook/x86/_index.po +++ /dev/null @@ -1,11157 +0,0 @@ -# SOME DESCRIPTIVE TITLE -# Copyright (C) YEAR The FreeBSD Project -# This file is distributed under the same license as the FreeBSD Documentation package. -# Vladlen Popolitov <vladlenpopolitov@list.ru>, 2025, 2026. -msgid "" -msgstr "" -"Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2025-11-08 16:17+0000\n" -"PO-Revision-Date: 2026-04-05 04:45+0000\n" -"Last-Translator: Vladlen Popolitov <vladlenpopolitov@list.ru>\n" -"Language-Team: Russian <https://translate-dev.freebsd.org/projects/" -"documentation/booksdevelopers-handbookx86_index/ru/>\n" -"Language: ru\n" -"MIME-Version: 1.0\n" -"Content-Type: text/plain; charset=UTF-8\n" -"Content-Transfer-Encoding: 8bit\n" -"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && " -"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n" -"X-Generator: Weblate 4.17\n" - -#. type: Title = -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:15 -#, no-wrap -msgid "x86 Assembly Language Programming" -msgstr "Программирование на ассемблере x86" - -#. type: YAML Front Matter: title -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1 -#, no-wrap -msgid "Chapter 11. x86 Assembly Language Programming" -msgstr "Глава 11. Программирование на языке ассемблера для x86" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:53 -msgid "_This chapter was written by {stanislav}._" -msgstr "_Эта глава была написана {stanislav}._" - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:55 -#, no-wrap -msgid "Synopsis" -msgstr "Обзор" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:59 -msgid "" -"Assembly language programming under UNIX(R) is highly undocumented. It is " -"generally assumed that no one would ever want to use it because various " -"UNIX(R) systems run on different microprocessors, so everything should be " -"written in C for portability." -msgstr "" -"Программирование на ассемблере в UNIX(R) крайне плохо документировано. " -"Обычно предполагается, что никто не захочет его использовать, поскольку " -"различные системы UNIX(R) работают на разных микропроцессорах, и поэтому всё " -"должно быть написано на C для обеспечения переносимости." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:63 -msgid "" -"In reality, C portability is quite a myth. Even C programs need to be " -"modified when ported from one UNIX(R) to another, regardless of what " -"processor each runs on. Typically, such a program is full of conditional " -"statements depending on the system it is compiled for." -msgstr "" -"В действительности переносимость программ на C — это скорее миф. Даже " -"программы на C требуют изменений при переносе с одной UNIX(R)-системы на " -"другую, независимо от процессора, на котором они работают. Обычно такая " -"программа содержит множество условных операторов, зависящих от системы, для " -"которой она компилируется." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:65 -msgid "" -"Even if we believe that all of UNIX(R) software should be written in C, or " -"some other high-level language, we still need assembly language programmers: " -"Who else would write the section of C library that accesses the kernel?" -msgstr "" -"Даже если мы считаем, что всё программное обеспечение UNIX(R) должно быть " -"написано на C или другом языке высокого уровня, нам всё равно нужны " -"программисты на ассемблере: кто же ещё напишет часть библиотеки C, которая " -"обращается к ядру?" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:67 -msgid "" -"In this chapter I will attempt to show you how you can use assembly language " -"writing UNIX(R) programs, specifically under FreeBSD." -msgstr "" -"В этой главе я попытаюсь показать вам, как можно использовать язык " -"ассемблера для написания программ под UNIX(R), в частности под FreeBSD." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:72 -msgid "" -"This chapter does not explain the basics of assembly language. There are " -"enough resources about that (for a complete online course in assembly " -"language, see Randall Hyde's http://webster.cs.ucr.edu/[Art of Assembly " -"Language]; or if you prefer a printed book, take a look at Jeff Duntemann's " -"Assembly Language Step-by-Step (ISBN: 0471375233). However, once the " -"chapter is finished, any assembly language programmer will be able to write " -"programs for FreeBSD quickly and efficiently." -msgstr "" -"В этой главе не объясняются основы языка ассемблера. Существует достаточно " -"ресурсов на эту тему (например, полный онлайн-курс по языку ассемблера можно " -"найти в http://webster.cs.ucr.edu/[Искусстве языка ассемблера] Рэндалла " -"Хайда; если вы предпочитаете печатные книги, обратите внимание на «Язык " -"ассемблера шаг за шагом» Джеффа Дантемана (ISBN: 0471375233)). Однако после " -"прочтения этой главы любой программист на языке ассемблера сможет писать " -"программы для FreeBSD быстро и эффективно." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:74 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4311 -msgid "Copyright (R) 2000-2001 G. Adam Stanislav. All rights reserved." -msgstr "Copyright (R) 2000-2001 G. Adam Stanislav. All rights reserved." - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:76 -#, no-wrap -msgid "The Tools" -msgstr "Инструменты" - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:79 -#, no-wrap -msgid "The Assembler" -msgstr "Ассемблер" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:82 -msgid "" -"The most important tool for assembly language programming is the assembler, " -"the software that converts assembly language code into machine language." -msgstr "" -"Важнейшим инструментом для программирования на языке ассемблера является " -"ассемблер — программа, преобразующая код на языке ассемблера в машинный код." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:85 -msgid "" -"Three very different assemblers are available for FreeBSD. Both man:llvm-" -"as[1] (included in package:devel/llvm[]) and man:as[1] (included in package:" -"devel/binutils[]) use the traditional UNIX(R) assembly language syntax." -msgstr "" -"Три очень разных ассемблера доступны для FreeBSD. И man:llvm-as[1] (включён " -"в package:devel/llvm[]), и man:as[1] (включён в package:devel/binutils[]) " -"используют традиционный синтаксис ассемблера UNIX(R)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:88 -msgid "" -"On the other hand, man:nasm[1] (installed through package:devel/nasm[]) uses " -"the Intel syntax. Its main advantage is that it can assemble code for many " -"operating systems." -msgstr "" -"С другой стороны, man:nasm[1] (устанавливаемый через package:devel/nasm[]) " -"использует синтаксис Intel. Его основное преимущество в том, что он может " -"ассемблировать код для многих операционных систем." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:91 -msgid "" -"This chapter uses nasm syntax because most assembly language programmers " -"coming to FreeBSD from other operating systems will find it easier to " -"understand. And, because, quite frankly, that is what I am used to." -msgstr "" -"В этой главе используется синтаксис nasm, потому что большинство " -"программистов на ассемблере, приходящих в FreeBSD из других операционных " -"систем, найдут его более понятным. Кроме того, если честно, это то, к чему я " -"привык." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:93 -#, no-wrap -msgid "The Linker" -msgstr "Компоновщик" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:96 -msgid "" -"The output of the assembler, like that of any compiler, needs to be linked " -"to form an executable file." -msgstr "" -"Результат работы ассемблера, как и любого компилятора, необходимо связать, " -"чтобы получить исполняемый файл." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:99 -msgid "" -"The standard man:ld[1] linker comes with FreeBSD. It works with the code " -"assembled with either assembler." -msgstr "" -"Стандартный компоновщик man:ld[1] поставляется с FreeBSD. Он работает с " -"кодом, собранным любым из ассемблеров." - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:101 -#, no-wrap -msgid "System Calls" -msgstr "Системные вызовы" - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:104 -#, no-wrap -msgid "Default Calling Convention" -msgstr "Стандартное соглашение о вызовах" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:108 -msgid "" -"By default, the FreeBSD kernel uses the C calling convention. Further, " -"although the kernel is accessed using `int 80h`, it is assumed the program " -"will call a function that issues `int 80h`, rather than issuing `int 80h` " -"directly." -msgstr "" -"По умолчанию ядро FreeBSD использует соглашение о вызовах C. Кроме того, " -"хотя доступ к ядру осуществляется с помощью `int 80h`, предполагается, что " -"программа вызовет функцию, которая выполняет `int 80h`, а не будет выполнять " -"`int 80h` напрямую." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:111 -msgid "" -"This convention is very convenient, and quite superior to the Microsoft(R) " -"convention used by MS-DOS(R). Why? Because the UNIX(R) convention allows " -"any program written in any language to access the kernel." -msgstr "" -"Эта традиция очень удобна и значительно превосходит соглашение Microsoft(R), " -"используемое в MS-DOS(R). Почему? Потому что соглашение UNIX(R) позволяет " -"любой программе, написанной на любом языке, обращаться к ядру." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:114 -msgid "" -"An assembly language program can do that as well. For example, we could " -"open a file:" -msgstr "" -"Программа на ассемблере также может это сделать. Например, мы могли бы " -"открыть файл:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:120 -#, no-wrap -msgid "" -"kernel:\n" -"\tint\t80h\t; Call kernel\n" -"\tret\n" -msgstr "" -"kernel:\n" -"\tint\t80h\t; Call kernel\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:129 -#, no-wrap -msgid "" -"open:\n" -"\tpush\tdword mode\n" -"\tpush\tdword flags\n" -"\tpush\tdword path\n" -"\tmov\teax, 5\n" -"\tcall\tkernel\n" -"\tadd\tesp, byte 12\n" -"\tret\n" -msgstr "" -"open:\n" -"\tpush\tdword mode\n" -"\tpush\tdword flags\n" -"\tpush\tdword path\n" -"\tmov\teax, 5\n" -"\tcall\tkernel\n" -"\tadd\tesp, byte 12\n" -"\tret\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:133 -msgid "" -"This is a very clean and portable way of coding. If you need to port the " -"code to a UNIX(R) system which uses a different interrupt, or a different " -"way of passing parameters, all you need to change is the kernel procedure." -msgstr "" -"Это очень понятный и переносимый способ написания кода. Если вам нужно " -"перенести код на UNIX(R)-систему, которая использует другое прерывание или " -"другой способ передачи параметров, все, что вам нужно изменить, это " -"процедуру kernel." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:137 -msgid "" -"But assembly language programmers like to shave off cycles. The above " -"example requires a `call/ret` combination. We can eliminate it by " -"``push``ing an extra dword:" -msgstr "" -"Но программисты на ассемблере любят экономить такты. Приведённый выше пример " -"требует комбинации `call/ret`. Мы можем исключить её, сделав ``push`` " -"дополнительного двойного слова:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:148 -#, no-wrap -msgid "" -"open:\n" -"\tpush\tdword mode\n" -"\tpush\tdword flags\n" -"\tpush\tdword path\n" -"\tmov\teax, 5\n" -"\tpush\teax\t\t; Or any other dword\n" -"\tint\t80h\n" -"\tadd\tesp, byte 16\n" -msgstr "" -"open:\n" -"\tpush\tdword mode\n" -"\tpush\tdword flags\n" -"\tpush\tdword path\n" -"\tmov\teax, 5\n" -"\tpush\teax\t\t; Or any other dword\n" -"\tint\t80h\n" -"\tadd\tesp, byte 16\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:151 -msgid "" -"The `5` that we have placed in `EAX` identifies the kernel function, in this " -"case `open`." -msgstr "" -"Помещённое в `EAX` значение `5` идентифицирует функцию ядра, в данном случае " -"`open`." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:153 -#, no-wrap -msgid "Alternate Calling Convention" -msgstr "Альтернативное соглашение о вызовах" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:158 -msgid "" -"FreeBSD is an extremely flexible system. It offers other ways of calling " -"the kernel. For it to work, however, the system must have Linux emulation " -"installed." -msgstr "" -"FreeBSD — это чрезвычайно гибкая система. Она предлагает другие способы " -"вызова ядра. Однако для работы необходимо, чтобы в системе была установлена " -"эмуляция Linux." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:163 -msgid "" -"Linux is a UNIX(R) like system. However, its kernel uses the same system-" -"call convention of passing parameters in registers MS-DOS(R) does. As with " -"the UNIX(R) convention, the function number is placed in `EAX`. The " -"parameters, however, are not passed on the stack but in `EBX, ECX, EDX, ESI, " -"EDI, EBP`:" -msgstr "" -"Linux — это система, подобная UNIX(R). Однако её ядро использует то же " -"соглашение о системных вызовов для передачи параметров в регистрах, что и MS-" -"DOS(R). Как и в соглашении UNIX(R), номер функции помещается в `EAX`. Однако " -"параметры передаются не в стеке, а в регистрах `EBX, ECX, EDX, ESI, EDI, " -"EBP`:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:172 -#, no-wrap -msgid "" -"open:\n" -"\tmov\teax, 5\n" -"\tmov\tebx, path\n" -"\tmov\tecx, flags\n" -"\tmov\tedx, mode\n" -"\tint\t80h\n" -msgstr "" -"open:\n" -"\tmov\teax, 5\n" -"\tmov\tebx, path\n" -"\tmov\tecx, flags\n" -"\tmov\tedx, mode\n" -"\tint\t80h\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:178 -msgid "" -"This convention has a great disadvantage over the UNIX(R) way, at least as " -"far as assembly language programming is concerned: Every time you make a " -"kernel call you must `push` the registers, then `pop` them later. This " -"makes your code bulkier and slower. Nevertheless, FreeBSD gives you a " -"choice." -msgstr "" -"Этот подход имеет значительный недостаток по сравнению с UNIX(R), по крайней " -"мере, в контексте программирования на ассемблере: каждый раз при вызове ядра " -"необходимо сохранять регистры с помощью `push`, а затем восстанавливать их с " -"помощью `pop`. Это делает ваш код более громоздким и медленным. Тем не " -"менее, FreeBSD предоставляет вам выбор." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:181 -msgid "" -"If you do choose the Linux convention, you must let the system know about " -"it. After your program is assembled and linked, you need to brand the " -"executable:" -msgstr "" -"Если вы решите использовать соглашение Linux, вы должны сообщить об этом " -"системе. После того как ваша программа будет ассемблирована и слинкована, " -"вам нужно пометить исполняемый файл:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:185 -#, no-wrap -msgid "% brandelf -t Linux filename\n" -msgstr "% brandelf -t Linux filename\n" - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:188 -#, no-wrap -msgid "Which Convention Should You Use?" -msgstr "Какое соглашение следует использовать?" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:193 -msgid "" -"If you are coding specifically for FreeBSD, you should always use the " -"UNIX(R) convention: It is faster, you can store global variables in " -"registers, you do not have to brand the executable, and you do not impose " -"the installation of the Linux emulation package on the target system." -msgstr "" -"Если вы разрабатываете код специально для FreeBSD, всегда следует " -"использовать соглашение UNIX(R): это быстрее, вы можете хранить глобальные " -"переменные в регистрах, вам не нужно маркировать исполняемый файл, и вы не " -"требуете установки пакета эмуляции Linux на целевой системе." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:196 -msgid "" -"If you want to create portable code that can also run on Linux, you will " -"probably still want to give the FreeBSD users as efficient a code as " -"possible. I will show you how you can accomplish that after I have " -"explained the basics." -msgstr "" -"Хотя вы можете хотеть создать переносимый код, который также работает на " -"Linux, вам, вероятно, по-прежнему будет нужен максимально эффективный код " -"для пользователей FreeBSD. Я покажу вам, как этого добиться, после того как " -"объясню основы." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:198 -#, no-wrap -msgid "Call Numbers" -msgstr "Номера вызовов" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:202 -msgid "" -"To tell the kernel which system service you are calling, place its number in " -"`EAX`. Of course, you need to know what the number is." -msgstr "" -"Чтобы сообщить ядру, какую системную службу вы вызываете, поместите её номер " -"в `EAX`. Разумеется, вам необходимо знать, что это за номер." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:204 -#, no-wrap -msgid "The [.filename]#syscalls# File" -msgstr "Файл [.filename]#syscalls#" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:208 -msgid "" -"The numbers are listed in [.filename]#syscalls#. `locate syscalls` finds " -"this file in several different formats, all produced automatically from [." -"filename]#syscalls.master#." -msgstr "" -"Номера перечислены в [.filename]#syscalls#. Команда `locate syscalls` " -"находит этот файл в нескольких различных форматах, все они создаются " -"автоматически из [.filename]#syscalls.master#." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:211 -msgid "" -"You can find the master file for the default UNIX(R) calling convention in [." -"filename]#/usr/src/sys/kern/syscalls.master#. If you need to use the other " -"convention implemented in the Linux emulation mode, read [.filename]#/usr/" -"src/sys/i386/linux/syscalls.master#." -msgstr "" -"Основной файл для стандартного соглашения о вызовах UNIX(R) можно найти в [." -"filename]#/usr/src/sys/kern/syscalls.master#. Если вам необходимо " -"использовать другое соглашение, реализованное в режиме эмуляции Linux, " -"обратитесь к [.filename]#/usr/src/sys/i386/linux/syscalls.master#." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:215 -msgid "" -"Not only do FreeBSD and Linux use different calling conventions, they " -"sometimes use different numbers for the same functions." -msgstr "" -"Не только FreeBSD и Linux используют разные соглашения о вызовах, но иногда " -"они используют разные номера для одних и тех же функций." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:218 -msgid "[.filename]#syscalls.master# describes how the call is to be made:" -msgstr "" -"[.filename]#syscalls.master# описывает, как должен быть выполнен вызов:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:229 -#, no-wrap -msgid "" -"0\tSTD\tNOHIDE\t{ int nosys(void); } syscall nosys_args int\n" -"1\tSTD\tNOHIDE\t{ void exit(int rval); } exit rexit_args void\n" -"2\tSTD\tPOSIX\t{ int fork(void); }\n" -"3\tSTD\tPOSIX\t{ ssize_t read(int fd, void *buf, size_t nbyte); }\n" -"4\tSTD\tPOSIX\t{ ssize_t write(int fd, const void *buf, size_t nbyte); }\n" -"5\tSTD\tPOSIX\t{ int open(char *path, int flags, int mode); }\n" -"6\tSTD\tPOSIX\t{ int close(int fd); }\n" -"etc...\n" -msgstr "" -"0\tSTD\tNOHIDE\t{ int nosys(void); } syscall nosys_args int\n" -"1\tSTD\tNOHIDE\t{ void exit(int rval); } exit rexit_args void\n" -"2\tSTD\tPOSIX\t{ int fork(void); }\n" -"3\tSTD\tPOSIX\t{ ssize_t read(int fd, void *buf, size_t nbyte); }\n" -"4\tSTD\tPOSIX\t{ ssize_t write(int fd, const void *buf, size_t nbyte); }\n" -"5\tSTD\tPOSIX\t{ int open(char *path, int flags, int mode); }\n" -"6\tSTD\tPOSIX\t{ int close(int fd); }\n" -"etc...\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:232 -msgid "It is the leftmost column that tells us the number to place in `EAX`." -msgstr "" -"Это крайний левый столбец, который указывает число, которое нужно поместить " -"в `EAX`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:235 -msgid "" -"The rightmost column tells us what parameters to `push`. They are " -"``push``ed _from right to left_." -msgstr "" -"Самый правый столбец указывает, какие параметры нужно `втолкнуть` в стек " -"командой push. Они `вталкиваются` _справа налево_." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:237 -msgid "" -"For example, to `open` a file, we need to `push` the `mode` first, then " -"`flags`, then the address at which the `path` is stored." -msgstr "" -"Например, чтобы `открыть` файл, нам сначала нужно сделать `push` для `mode`, " -"затем `flags`, а затем адрес, по которому хранится `path`." - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:239 -#, no-wrap -msgid "Return Values" -msgstr "Возвращаемые значения" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:243 -msgid "" -"A system call would not be useful most of the time if it did not return some " -"kind of a value: The file descriptor of an open file, the number of bytes " -"read to a buffer, the system time, etc." -msgstr "" -"От системных вызовов не было бы никакой пользы, если бы они не возвращали " -"какое-либо значение: дескриптор открытого файла, количество байтов, " -"прочитанных в буфер, системное время и т.д." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:246 -msgid "" -"Additionally, the system needs to inform us if an error occurs: A file does " -"not exist, system resources are exhausted, we passed an invalid parameter, " -"etc." -msgstr "" -"Кроме того, система должна уведомлять нас, если возникает ошибка: файл не " -"существует, системные ресурсы исчерпаны, передан недопустимый параметр и т. " -"д." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:248 -#, no-wrap -msgid "Man Pages" -msgstr "Страницы Справочника" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:252 -msgid "" -"The traditional place to look for information about various system calls " -"under UNIX(R) systems are the manual pages. FreeBSD describes its system " -"calls in section 2, sometimes in section 3." -msgstr "" -"Традиционным источником информации о различных системных вызовах в UNIX(R)-" -"системах являются страницы Справочника. В FreeBSD системные вызовы описаны в " -"разделе 2, иногда в разделе 3." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:254 -msgid "For example, man:open[2] says:" -msgstr "Например, man:open[2] говорит:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:258 -msgid "" -"If successful, `open()` returns a non-negative integer, termed a file " -"descriptor. It returns `-1` on failure, and sets `errno` to indicate the " -"error." -msgstr "" -"В случае успеха `open()` возвращает неотрицательное целое число, называемое " -"файловым дескриптором. В случае ошибки возвращается `-1`, а переменной " -"`errno` присваивается код ошибки." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:260 -msgid "" -"The assembly language programmer new to UNIX(R) and FreeBSD will immediately " -"ask the puzzling question: Where is `errno` and how do I get to it?" -msgstr "" -"Программист на ассемблере, впервые столкнувшийся с UNIX(R) и FreeBSD, сразу " -"же задастся вопросом: где находится `errno` и как к ней обратиться?" - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:265 -msgid "" -"The information presented in the manual pages applies to C programs. The " -"assembly language programmer needs additional information." -msgstr "" -"Информация, представленная в руководствах, применима к программам на языке " -"C. Программистам на языке ассемблера требуется дополнительная информация." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:268 -#, no-wrap -msgid "Where Are the Return Values?" -msgstr "Где возвращаемые значения?" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:273 -msgid "" -"Unfortunately, it depends... For most system calls it is in `EAX`, but not " -"for all. A good rule of thumb, when working with a system call for the " -"first time, is to look for the return value in `EAX`. If it is not there, " -"you need further research." -msgstr "" -"К сожалению, это зависит от ситуации... Для большинства системных вызовов " -"возвращаемое значение находится в `EAX`, но не для всех. Хорошее правило при " -"первой работе с системным вызовом — искать возвращаемое значение в `EAX`. " -"Если его там нет, потребуется дополнительное исследование." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:279 -msgid "" -"I am aware of one system call that returns the value in `EDX`: `SYS_fork`. " -"All others I have worked with use `EAX`. But I have not worked with them " -"all yet." -msgstr "" -"Я знаю о одном системном вызове, который возвращает значение в `EDX`: " -"`SYS_fork`. Все остальные, с которыми я работал, используют `EAX`. Но я ещё " -"не работал со всеми из них." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:284 -msgid "" -"If you cannot find the answer here or anywhere else, study libc source code " -"and see how it interfaces with the kernel." -msgstr "" -"Если вы не можете найти ответ здесь или где-либо ещё, изучите исходный код " -"libc и посмотрите, как он взаимодействует с ядром." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:287 -#, no-wrap -msgid "Where Is `errno`?" -msgstr "Где находится `errno`?" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:290 -msgid "Actually, nowhere..." -msgstr "Фактически, нигде..." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:293 -msgid "" -"`errno` is part of the C language, not the UNIX(R) kernel. When accessing " -"kernel services directly, the error code is returned in `EAX`, the same " -"register the proper return value generally ends up in." -msgstr "" -"`errno` является частью языка C, а не ядра UNIX(R). При прямом доступе к " -"сервисам ядра код ошибки возвращается в регистре `EAX` — том же регистре, в " -"котором обычно оказывается корректное возвращаемое значение." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:297 -msgid "" -"This makes perfect sense. If there is no error, there is no error code. If " -"there is an error, there is no return value. One register can contain " -"either." -msgstr "" -"Это совершенно логично. Если нет ошибки, то нет и кода ошибки. Если есть " -"ошибка, то нет возвращаемого значения. Один регистр может содержать либо то, " -"либо другое." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:299 -#, no-wrap -msgid "Determining an Error Occurred" -msgstr "Определение возникновения ошибки" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:302 -msgid "" -"When using the standard FreeBSD calling convention, the `carry flag` is " -"cleared upon success, set upon failure." -msgstr "" -"При использовании стандартного соглашения о вызовах FreeBSD флаг `carry " -"flag` сбрасывается при успехе и устанавливается при неудаче." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:305 -msgid "" -"When using the Linux emulation mode, the signed value in `EAX` is non-" -"negative upon success, and contains the return value. In case of an error, " -"the value is negative, i.e., `-errno`." -msgstr "" -"При использовании режима эмуляции Linux знаковое значение в `EAX` " -"неотрицательно в случае успеха и содержит возвращаемое значение. В случае " -"ошибки значение отрицательное, т.е. `-errno`." - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:307 -#, no-wrap -msgid "Creating Portable Code" -msgstr "Создание переносимого кода" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:312 -msgid "" -"Portability is generally not one of the strengths of assembly language. " -"Yet, writing assembly language programs for different platforms is possible, " -"especially with nasm. I have written assembly language libraries that can " -"be assembled for such different operating systems as Windows(R) and FreeBSD." -msgstr "" -"Портативность обычно не является сильной стороной языка ассемблера. Тем не " -"менее, написание программ на ассемблере для разных платформ возможно, " -"особенно с использованием nasm. Я создавал библиотеки на ассемблере, которые " -"можно было собрать для таких разных операционных систем, как Windows(R) и " -"FreeBSD." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:314 -msgid "" -"It is all the more possible when you want your code to run on two platforms " -"which, while different, are based on similar architectures." -msgstr "" -"Это становится ещё более возможным, когда вы хотите, чтобы ваш код работал " -"на двух платформах, которые, хотя и различны, основаны на схожих " -"архитектурах." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:318 -msgid "" -"For example, FreeBSD is UNIX(R), Linux is UNIX(R) like. I only mentioned " -"three differences between them (from an assembly language programmer's " -"perspective): The calling convention, the function numbers, and the way of " -"returning values." -msgstr "" -"Например, FreeBSD — это UNIX(R), а Linux — UNIX(R)-подобная система. Я " -"упомянул лишь три различия между ними (с точки зрения программиста на " -"ассемблере): соглашение о вызовах, номера функций и способ возврата значений." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:320 -#, no-wrap -msgid "Dealing with Function Numbers" -msgstr "Работа с номерами функций" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:325 -msgid "" -"In many cases the function numbers are the same. However, even when they " -"are not, the problem is easy to deal with: Instead of using numbers in your " -"code, use constants which you have declared differently depending on the " -"target architecture:" -msgstr "" -"Во многих случаях номера функций совпадают. Однако, даже если это не так, " -"проблему легко решить: вместо использования чисел в коде применяйте " -"константы, объявленные по-разному в зависимости от целевой архитектуры:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:333 -#, no-wrap -msgid "" -"%ifdef\tLINUX\n" -"%define\tSYS_execve\t11\n" -"%else\n" -"%define\tSYS_execve\t59\n" -"%endif\n" -msgstr "" -"%ifdef\tLINUX\n" -"%define\tSYS_execve\t11\n" -"%else\n" -"%define\tSYS_execve\t59\n" -"%endif\n" - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:336 -#, no-wrap -msgid "Dealing with Conventions" -msgstr "Работа с соглашениями" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:339 -msgid "" -"Both, the calling convention, and the return value (the `errno` problem) can " -"be resolved with macros:" -msgstr "" -"Оба, соглашение о вызовах и возвращаемое значение (проблема `errno`) могут " -"быть решены с помощью макросов:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:343 -#, no-wrap -msgid "%ifdef\tLINUX\n" -msgstr "%ifdef\tLINUX\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:347 -#, no-wrap -msgid "" -"%macro\tsystem\t0\n" -"\tcall\tkernel\n" -"%endmacro\n" -msgstr "" -"%macro\tsystem\t0\n" -"\tcall\tkernel\n" -"%endmacro\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:356 -#, no-wrap -msgid "" -"align 4\n" -"kernel:\n" -"\tpush\tebx\n" -"\tpush\tecx\n" -"\tpush\tedx\n" -"\tpush\tesi\n" -"\tpush\tedi\n" -"\tpush\tebp\n" -msgstr "" -"align 4\n" -"kernel:\n" -"\tpush\tebx\n" -"\tpush\tecx\n" -"\tpush\tedx\n" -"\tpush\tesi\n" -"\tpush\tedi\n" -"\tpush\tebp\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:363 -#, no-wrap -msgid "" -"\tmov\tebx, [esp+32]\n" -"\tmov\tecx, [esp+36]\n" -"\tmov\tedx, [esp+40]\n" -"\tmov\tesi, [esp+44]\n" -"\tmov\tebp, [esp+48]\n" -"\tint\t80h\n" -msgstr "" -"\tmov\tebx, [esp+32]\n" -"\tmov\tecx, [esp+36]\n" -"\tmov\tedx, [esp+40]\n" -"\tmov\tesi, [esp+44]\n" -"\tmov\tebp, [esp+48]\n" -"\tint\t80h\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:370 -#, no-wrap -msgid "" -"\tpop\tebp\n" -"\tpop\tedi\n" -"\tpop\tesi\n" -"\tpop\tedx\n" -"\tpop\tecx\n" -"\tpop\tebx\n" -msgstr "" -"\tpop\tebp\n" -"\tpop\tedi\n" -"\tpop\tesi\n" -"\tpop\tedx\n" -"\tpop\tecx\n" -"\tpop\tebx\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:375 -#, no-wrap -msgid "" -"\tor\teax, eax\n" -"\tjs\t.errno\n" -"\tclc\n" -"\tret\n" -msgstr "" -"\tor\teax, eax\n" -"\tjs\t.errno\n" -"\tclc\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:380 -#, no-wrap -msgid "" -".errno:\n" -"\tneg\teax\n" -"\tstc\n" -"\tret\n" -msgstr "" -".errno:\n" -"\tneg\teax\n" -"\tstc\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:382 -#, no-wrap -msgid "%else\n" -msgstr "%else\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:386 -#, no-wrap -msgid "" -"%macro\tsystem\t0\n" -"\tint\t80h\n" -"%endmacro\n" -msgstr "" -"%macro\tsystem\t0\n" -"\tint\t80h\n" -"%endmacro\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:388 -#, no-wrap -msgid "%endif\n" -msgstr "%endif\n" - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:391 -#, no-wrap -msgid "Dealing with Other Portability Issues" -msgstr "Устранение прочих проблем с переносимостью" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:395 -msgid "" -"The above solutions can handle most cases of writing code portable between " -"FreeBSD and Linux. Nevertheless, with some kernel services the differences " -"are deeper." -msgstr "" -"Приведённые выше решения могут помочь в большинстве случаев написания кода, " -"переносимого между FreeBSD и Linux. Тем не менее, с некоторыми сервисами " -"ядра различия более глубокие." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:398 -msgid "" -"In that case, you need to write two different handlers for those particular " -"system calls, and use conditional assembly. Luckily, most of your code does " -"something other than calling the kernel, so usually you will only need a few " -"such conditional sections in your code." -msgstr "" -"В таком случае необходимо написать два разных обработчика для этих " -"конкретных системных вызовов и использовать условную компиляцию. К счастью, " -"большая часть вашего кода выполняет действия, отличные от вызовов ядра, " -"поэтому обычно потребуется лишь несколько таких условных секций в коде." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:400 -#, no-wrap -msgid "Using a Library" -msgstr "Использование библиотеки" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:404 -msgid "" -"You can avoid portability issues in your main code altogether by writing a " -"library of system calls. Create a separate library for FreeBSD, a different " -"one for Linux, and yet other libraries for more operating systems." -msgstr "" -"Вы можете полностью избежать проблем с переносимостью в основном коде, " -"написав библиотеку системных вызовов. Создайте отдельную библиотеку для " -"FreeBSD, другую для Linux и ещё другие библиотеки для дополнительных " -"операционных систем." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:409 -msgid "" -"In your library, write a separate function (or procedure, if you prefer the " -"traditional assembly language terminology) for each system call. Use the C " -"calling convention of passing parameters. But still use `EAX` to pass the " -"call number in. In that case, your FreeBSD library can be very simple, as " -"many seemingly different functions can be just labels to the same code:" -msgstr "" -"В вашей библиотеке напишите отдельную функцию (или процедуру, если вы " -"предпочитаете традиционную терминологию ассемблера) для каждого системного " -"вызова. Используйте соглашение о вызовах C для передачи параметров. Однако " -"по-прежнему передавайте номер вызова через `EAX`. В таком случае ваша " -"библиотека FreeBSD может быть очень простой, так как множество внешне " -"различных функций могут быть просто метками одного и того же кода:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:417 -#, no-wrap -msgid "" -"sys.open:\n" -"sys.close:\n" -"[etc...]\n" -"\tint\t80h\n" -"\tret\n" -msgstr "" -"sys.open:\n" -"sys.close:\n" -"[etc...]\n" -"\tint\t80h\n" -"\tret\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:421 -msgid "" -"Your Linux library will require more different functions. But even here you " -"can group system calls using the same number of parameters:" -msgstr "" -"Ваша библиотека Linux потребует больше различных функций. Но даже здесь вы " -"можете группировать системные вызовы, используя одинаковое количество " -"параметров:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:432 -#, no-wrap -msgid "" -"sys.exit:\n" -"sys.close:\n" -"[etc... one-parameter functions]\n" -"\tpush\tebx\n" -"\tmov\tebx, [esp+12]\n" -"\tint\t80h\n" -"\tpop\tebx\n" -"\tjmp\tsys.return\n" -msgstr "" -"sys.exit:\n" -"sys.close:\n" -"[etc... one-parameter functions]\n" -"\tpush\tebx\n" -"\tmov\tebx, [esp+12]\n" -"\tint\t80h\n" -"\tpop\tebx\n" -"\tjmp\tsys.return\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:434 -#, no-wrap -msgid "...\n" -msgstr "...\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:440 -#, no-wrap -msgid "" -"sys.return:\n" -"\tor\teax, eax\n" -"\tjs\tsys.err\n" -"\tclc\n" -"\tret\n" -msgstr "" -"sys.return:\n" -"\tor\teax, eax\n" -"\tjs\tsys.err\n" -"\tclc\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:445 -#, no-wrap -msgid "" -"sys.err:\n" -"\tneg\teax\n" -"\tstc\n" -"\tret\n" -msgstr "" -"sys.err:\n" -"\tneg\teax\n" -"\tstc\n" -"\tret\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:452 -msgid "" -"The library approach may seem inconvenient at first because it requires you " -"to produce a separate file your code depends on. But it has many " -"advantages: For one, you only need to write it once and can use it for all " -"your programs. You can even let other assembly language programmers use it, " -"or perhaps use one written by someone else. But perhaps the greatest " -"advantage of the library is that your code can be ported to other systems, " -"even by other programmers, by simply writing a new library without any " -"changes to your code." -msgstr "" -"Подход с использованием библиотек может показаться неудобным на первый " -"взгляд, так как требует создания отдельного файла, от которого зависит ваш " -"код. Однако у него есть множество преимуществ: во-первых, вам нужно написать " -"его лишь один раз, и затем вы можете использовать его во всех своих " -"программах. Вы даже можете позволить другим программистам на ассемблере " -"использовать его или, возможно, воспользоваться библиотекой, написанной кем-" -"то другим. Но, пожалуй, самое большое преимущество библиотеки заключается в " -"том, что ваш код может быть перенесён на другие системы, даже другими " -"программистами, просто путём написания новой библиотеки без каких-либо " -"изменений в вашем коде." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:454 -msgid "" -"If you do not like the idea of having a library, you can at least place all " -"your system calls in a separate assembly language file and link it with your " -"main program. Here, again, all porters have to do is create a new object " -"file to link with your main program." -msgstr "" -"Если вам не нравится идея использования библиотеки, вы можете хотя бы " -"разместить все системные вызовы в отдельном файле на ассемблере и " -"скомпоновать его с основной программой. Здесь, опять же, все, что нужно " -"сделать переносчикам, — это создать новый объектный файл для компоновки с " -"основной программой." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:456 -#, no-wrap -msgid "Using an Include File" -msgstr "Использование включаемого файла" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:459 -msgid "" -"If you are releasing your software as (or with) source code, you can use " -"macros and place them in a separate file, which you include in your code." -msgstr "" -"Если вы выпускаете своё программное обеспечение в виде исходного кода (или " -"вместе с ним), вы можете использовать макросы и размещать их в отдельном " -"файле, который включается в ваш код." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:462 -msgid "" -"Porters of your software will simply write a new include file. No library " -"or external object file is necessary, yet your code is portable without any " -"need to edit the code." -msgstr "" -"Портеры вашего программного обеспечения просто напишут новый include-файл. " -"Никакая библиотека или внешний объектный файл не требуются, и ваш код " -"остаётся переносимым без необходимости редактирования." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:467 -msgid "" -"This is the approach we will use throughout this chapter. We will name our " -"include file [.filename]#system.inc#, and add to it whenever we deal with a " -"new system call." -msgstr "" -"Это подход, который мы будем использовать на протяжении всей главы. Мы " -"назовем наш включаемый файл [.filename]#system.inc# и будем добавлять в него " -"новые системные вызовы по мере их рассмотрения." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:470 -msgid "" -"We can start our [.filename]#system.inc# by declaring the standard file " -"descriptors:" -msgstr "" -"Мы можем начать наш [.filename]#system.inc# с объявления стандартных " -"файловых дескрипторов:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:476 -#, no-wrap -msgid "" -"%define\tstdin\t0\n" -"%define\tstdout\t1\n" -"%define\tstderr\t2\n" -msgstr "" -"%define\tstdin\t0\n" -"%define\tstdout\t1\n" -"%define\tstderr\t2\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:479 -msgid "Next, we create a symbolic name for each system call:" -msgstr "Далее мы создаем символическое имя для каждого системного вызова:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:488 -#, no-wrap -msgid "" -"%define\tSYS_nosys\t0\n" -"%define\tSYS_exit\t1\n" -"%define\tSYS_fork\t2\n" -"%define\tSYS_read\t3\n" -"%define\tSYS_write\t4\n" -"; [etc...]\n" -msgstr "" -"%define\tSYS_nosys\t0\n" -"%define\tSYS_exit\t1\n" -"%define\tSYS_fork\t2\n" -"%define\tSYS_read\t3\n" -"%define\tSYS_write\t4\n" -"; [etc...]\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:491 -msgid "" -"We add a short, non-global procedure with a long name, so we do not " -"accidentally reuse the name in our code:" -msgstr "" -"Добавляем короткую, неглобальную процедуру с длинным именем, чтобы случайно " -"не использовать это имя в нашем коде:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:499 -#, no-wrap -msgid "" -"section\t.text\n" -"align 4\n" -"access.the.bsd.kernel:\n" -"\tint\t80h\n" -"\tret\n" -msgstr "" -"section\t.text\n" -"align 4\n" -"access.the.bsd.kernel:\n" -"\tint\t80h\n" -"\tret\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:502 -msgid "We create a macro which takes one argument, the syscall number:" -msgstr "" -"Мы создаем макрос, который принимает один аргумент — номер системного вызова:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:509 -#, no-wrap -msgid "" -"%macro\tsystem\t1\n" -"\tmov\teax, %1\n" -"\tcall\taccess.the.bsd.kernel\n" -"%endmacro\n" -msgstr "" -"%macro\tsystem\t1\n" -"\tmov\teax, %1\n" -"\tcall\taccess.the.bsd.kernel\n" -"%endmacro\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:513 -msgid "" -"Finally, we create macros for each syscall. These macros take no arguments." -msgstr "" -"Наконец, мы создаем макросы для каждого системного вызова. Эти макросы не " -"принимают аргументов." - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:519 -#, no-wrap -msgid "" -"%macro\tsys.exit\t0\n" -"\tsystem\tSYS_exit\n" -"%endmacro\n" -msgstr "" -"%macro\tsys.exit\t0\n" -"\tsystem\tSYS_exit\n" -"%endmacro\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:523 -#, no-wrap -msgid "" -"%macro\tsys.fork\t0\n" -"\tsystem\tSYS_fork\n" -"%endmacro\n" -msgstr "" -"%macro\tsys.fork\t0\n" -"\tsystem\tSYS_fork\n" -"%endmacro\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:527 -#, no-wrap -msgid "" -"%macro\tsys.read\t0\n" -"\tsystem\tSYS_read\n" -"%endmacro\n" -msgstr "" -"%macro\tsys.read\t0\n" -"\tsystem\tSYS_read\n" -"%endmacro\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:531 -#, no-wrap -msgid "" -"%macro\tsys.write\t0\n" -"\tsystem\tSYS_write\n" -"%endmacro\n" -msgstr "" -"%macro\tsys.write\t0\n" -"\tsystem\tSYS_write\n" -"%endmacro\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:533 -#, no-wrap -msgid "; [etc...]\n" -msgstr "; [etc...]\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:537 -msgid "" -"Go ahead, enter it into your editor and save it as [.filename]#system.inc#. " -"We will add more to it as we discuss more syscalls." -msgstr "" -"Продолжайте, введите это в ваш редактор и сохраните как [.filename]#system." -"inc#. Мы добавим больше по мере обсуждения дополнительных системных вызовов." - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:539 -#, no-wrap -msgid "Our First Program" -msgstr "Наша первая программа" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:542 -msgid "We are now ready for our first program, the mandatory Hello, World!" -msgstr "Мы готовы к нашей первой обязательной программе — Hello, World!" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:546 -#, no-wrap -msgid "\t%include\t'system.inc'\n" -msgstr "\t%include\t'system.inc'\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:550 -#, no-wrap -msgid "" -"\tsection\t.data\n" -"\thello\tdb\t'Hello, World!', 0Ah\n" -"\thbytes\tequ\t$-hello\n" -msgstr "" -"\tsection\t.data\n" -"\thello\tdb\t'Hello, World!', 0Ah\n" -"\thbytes\tequ\t$-hello\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:558 -#, no-wrap -msgid "" -"\tsection\t.text\n" -"\tglobal\t_start\n" -"_start:\n" -"\tpush\tdword hbytes\n" -"\tpush\tdword hello\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -msgstr "" -"\tsection\t.text\n" -"\tglobal\t_start\n" -"_start:\n" -"\tpush\tdword hbytes\n" -"\tpush\tdword hello\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:561 -#, no-wrap -msgid "" -"\tpush\tdword 0\n" -"\tsys.exit\n" -msgstr "" -"\tpush\tdword 0\n" -"\tsys.exit\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:564 -msgid "" -"Here is what it does: Line 1 includes the defines, the macros, and the code " -"from [.filename]#system.inc#." -msgstr "" -"Вот что он делает: Строка 1 включает определения, макросы и код из файла [." -"filename]#system.inc#." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:568 -msgid "" -"Lines 3-5 are the data: Line 3 starts the data section/segment. Line 4 " -"contains the string \"Hello, World!\" followed by a new line (`0Ah`). Line " -"5 creates a constant that contains the length of the string from line 4 in " -"bytes." -msgstr "" -"Строки 3-5 содержат данные: строка 3 начинает раздел/сегмент данных. Строка " -"4 содержит строку \"Hello, World!\", за которой следует новая строка (`0Ah`)" -". Строка 5 создаёт константу, содержащую длину строки из строки 4 в байтах." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:572 -msgid "" -"Lines 7-16 contain the code. Note that FreeBSD uses the _elf_ file format " -"for its executables, which requires every program to start at the point " -"labeled `_start` (or, more precisely, the linker expects that). This label " -"has to be global." -msgstr "" -"Строки 7-16 содержат код. Обратите внимание, что FreeBSD использует формат " -"файлов _elf_ для исполняемых файлов, который требует, чтобы каждая программа " -"запускается с адреса, помеченного как `_start` (или, точнее, компоновщик " -"ожидает этого). Эта метка должна быть глобальной." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:574 -msgid "" -"Lines 10-13 ask the system to write `hbytes` bytes of the `hello` string to " -"`stdout`." -msgstr "" -"Строки 10-13 указывают системе записать `hbytes` байтов строки `hello` в " -"`stdout`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:577 -msgid "" -"Lines 15-16 ask the system to end the program with the return value of `0`. " -"The `SYS_exit` syscall never returns, so the code ends there." -msgstr "" -"Строки 15-16 указывают системе завершить программу с возвращаемым значением " -"`0`. Системный вызов `SYS_exit` никогда не возвращает управление, поэтому " -"код завершается в этой точке." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:585 -msgid "" -"If you have come to UNIX(R) from MS-DOS(R) assembly language background, you " -"may be used to writing directly to the video hardware. You will never have " -"to worry about this in FreeBSD, or any other flavor of UNIX(R). As far as " -"you are concerned, you are writing to a file known as [.filename]#stdout#. " -"This can be the video screen, or a telnet terminal, or an actual file, or " -"even the input of another program. Which one it is, is for the system to " -"figure out." -msgstr "" -"Если вы перешли на UNIX(R) с опытом программирования на ассемблере для MS-" -"DOS(R), вы, возможно, привыкли писать напрямую в видеопамять. В FreeBSD или " -"любой другой разновидности UNIX(R) вам не придётся об этом беспокоиться. С " -"вашей точки зрения, вы записываете данные в файл под названием [." -"filename]#stdout#. Это может быть экран, терминал telnet, обычный файл или " -"даже входные данные другой программы. Определять, что именно это будет, — " -"задача системы." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:588 -#, no-wrap -msgid "Assembling the Code" -msgstr "Ассемблирование кода" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:592 -msgid "" -"Type the code in an editor, and save it in a file named [.filename]#hello." -"asm#. You need nasm to assemble it." -msgstr "" -"Наберите код в редакторе и сохраните его в файле с именем [.filename]#hello." -"asm#. Для сборки вам понадобится nasm." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:594 -#, no-wrap -msgid "Installing nasm" -msgstr "Установка nasm" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:597 -msgid "If you do not have nasm, type:" -msgstr "Если у вас нет nasm, введите:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:606 -#, no-wrap -msgid "" -"% su\n" -"Password:your root password\n" -"# cd /usr/ports/devel/nasm\n" -"# make install\n" -"# exit\n" -"%\n" -msgstr "" -"% su\n" -"Password:your root password\n" -"# cd /usr/ports/devel/nasm\n" -"# make install\n" -"# exit\n" -"%\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:609 -msgid "" -"You may type `make install clean` instead of just `make install` if you do " -"not want to keep nasm source code." -msgstr "" -"Вы можете ввести `make install clean` вместо просто `make install`, если не " -"хотите сохранять исходный код nasm." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:611 -msgid "" -"Either way, FreeBSD will automatically download nasm from the Internet, " -"compile it, and install it on your system." -msgstr "" -"В любом случае FreeBSD автоматически загрузит nasm из интернета, " -"скомпилирует его и установит в вашу систему." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:616 -msgid "" -"If your system is not FreeBSD, you need to get nasm from its https://" -"sourceforge.net/projects/nasm[home page]. You can still use it to assemble " -"FreeBSD code." -msgstr "" -"Если ваша система не FreeBSD, вам нужно получить nasm с его https://" -"sourceforge.net/projects/nasm[домашней страницы]. Вы по-прежнему можете " -"использовать его для ассемблирования кода FreeBSD." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:619 -msgid "Now you can assemble, link, and run the code:" -msgstr "Теперь вы можете собрать, скомпоновать и запустить код:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:627 -#, no-wrap -msgid "" -"% nasm -f elf hello.asm\n" -"% ld -s -o hello hello.o\n" -"% ./hello\n" -"Hello, World!\n" -"%\n" -msgstr "" -"% nasm -f elf hello.asm\n" -"% ld -s -o hello hello.o\n" -"% ./hello\n" -"Hello, World!\n" -"%\n" - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:630 -#, no-wrap -msgid "Writing UNIX(R) Filters" -msgstr "Написание фильтров UNIX(R)" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:633 -msgid "" -"A common type of UNIX(R) application is a filter-a program that reads data " -"from the [.filename]#stdin#, processes it somehow, then writes the result to " -"[.filename]#stdout#." -msgstr "" -"Распространённым типом приложений в UNIX(R) являются фильтры — программы, " -"которые читают данные из [.filename]#stdin#, обрабатывают их определённым " -"образом, а затем записывают результат в [.filename]#stdout#." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:636 -msgid "" -"In this chapter, we shall develop a simple filter, and learn how to read " -"from [.filename]#stdin# and write to [.filename]#stdout#. This filter will " -"convert each byte of its input into a hexadecimal number followed by a blank " -"space." -msgstr "" -"В этой главе мы разработаем простой фильтр и научимся читать из [." -"filename]#stdin# и писать в [.filename]#stdout#. Этот фильтр будет " -"преобразовывать каждый байт входных данных в шестнадцатеричное число, за " -"которым следует пробел." - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:640 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:734 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:824 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:952 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1219 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2337 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3335 -#, no-wrap -msgid "%include\t'system.inc'\n" -msgstr "%include\t'system.inc'\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:644 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:738 -#, no-wrap -msgid "" -"section\t.data\n" -"hex\tdb\t'0123456789ABCDEF'\n" -"buffer\tdb\t0, 0, ' '\n" -msgstr "" -"section\t.data\n" -"hex\tdb\t'0123456789ABCDEF'\n" -"buffer\tdb\t0, 0, ' '\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:656 -#, no-wrap -msgid "" -"section\t.text\n" -"global\t_start\n" -"_start:\n" -"\t; read a byte from stdin\n" -"\tpush\tdword 1\n" -"\tpush\tdword buffer\n" -"\tpush\tdword stdin\n" -"\tsys.read\n" -"\tadd\tesp, byte 12\n" -"\tor\teax, eax\n" -"\tje\t.done\n" -msgstr "" -"section\t.text\n" -"global\t_start\n" -"_start:\n" -"\t; read a byte from stdin\n" -"\tpush\tdword 1\n" -"\tpush\tdword buffer\n" -"\tpush\tdword stdin\n" -"\tsys.read\n" -"\tadd\tesp, byte 12\n" -"\tor\teax, eax\n" -"\tje\t.done\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:666 -#, no-wrap -msgid "" -"\t; convert it to hex\n" -"\tmovzx\teax, byte [buffer]\n" -"\tmov\tedx, eax\n" -"\tshr\tdl, 4\n" -"\tmov\tdl, [hex+edx]\n" -"\tmov\t[buffer], dl\n" -"\tand\tal, 0Fh\n" -"\tmov\tal, [hex+eax]\n" -"\tmov\t[buffer+1], al\n" -msgstr "" -"\t; convert it to hex\n" -"\tmovzx\teax, byte [buffer]\n" -"\tmov\tedx, eax\n" -"\tshr\tdl, 4\n" -"\tmov\tdl, [hex+edx]\n" -"\tmov\t[buffer], dl\n" -"\tand\tal, 0Fh\n" -"\tmov\tal, [hex+eax]\n" -"\tmov\t[buffer+1], al\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:674 -#, no-wrap -msgid "" -"\t; print it\n" -"\tpush\tdword 3\n" -"\tpush\tdword buffer\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -"\tadd\tesp, byte 12\n" -"\tjmp\tshort _start\n" -msgstr "" -"\t; print it\n" -"\tpush\tdword 3\n" -"\tpush\tdword buffer\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -"\tadd\tesp, byte 12\n" -"\tjmp\tshort _start\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:678 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:781 -#, no-wrap -msgid "" -".done:\n" -"\tpush\tdword 0\n" -"\tsys.exit\n" -msgstr "" -".done:\n" -"\tpush\tdword 0\n" -"\tsys.exit\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:686 -msgid "" -"In the data section we create an array called `hex`. It contains the 16 " -"hexadecimal digits in ascending order. The array is followed by a buffer " -"which we will use for both input and output. The first two bytes of the " -"buffer are initially set to `0`. This is where we will write the two " -"hexadecimal digits (the first byte also is where we will read the input). " -"The third byte is a space." -msgstr "" -"В разделе данных мы создаем массив с именем `hex`. Он содержит 16 " -"шестнадцатеричных цифр в порядке возрастания. За массивом следует буфер, " -"который мы будем использовать как для ввода, так и для вывода. Первые два " -"байта буфера изначально установлены в `0`. Именно сюда мы будем записывать " -"две шестнадцатеричные цифры (первый байт также является местом, откуда мы " -"будем считывать ввод). Третий байт — это пробел." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:688 -msgid "" -"The code section consists of four parts: Reading the byte, converting it to " -"a hexadecimal number, writing the result, and eventually exiting the program." -msgstr "" -"Фрагмент кода состоит из четырёх частей: чтение байта, преобразование его в " -"шестнадцатеричное число, запись результата и завершение программы." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:694 -msgid "" -"To read the byte, we ask the system to read one byte from [." -"filename]#stdin#, and store it in the first byte of the `buffer`. The " -"system returns the number of bytes read in `EAX`. This will be `1` while " -"data is coming, or `0`, when no more input data is available. Therefore, we " -"check the value of `EAX`. If it is `0`, we jump to `.done`, otherwise we " -"continue." -msgstr "" -"Для чтения байта мы просим систему прочитать один байт из [.filename]#stdin# " -"и сохранить его в первом байте `buffer`. Система возвращает количество " -"прочитанных байтов в `EAX`. Это значение будет `1`, пока поступают данные, " -"или `0`, если больше нет доступных входных данных. Поэтому мы проверяем " -"значение `EAX`. Если оно равно `0`, мы переходим к метке `.done`, в " -"противном случае продолжаем выполнение." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:698 -msgid "" -"For simplicity sake, we are ignoring the possibility of an error condition " -"at this time." -msgstr "Для простоты мы пока игнорируем возможность возникновения ошибки." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:703 -msgid "" -"The hexadecimal conversion reads the byte from the `buffer` into `EAX`, or " -"actually just `AL`, while clearing the remaining bits of `EAX` to zeros. We " -"also copy the byte to `EDX` because we need to convert the upper four bits " -"(nibble) separately from the lower four bits. We store the result in the " -"first two bytes of the buffer." -msgstr "" -"Шестнадцатеричное преобразование считывает байт из `buffer` в `EAX`, а " -"точнее только в `AL`, обнуляя остальные биты `EAX`. Мы также копируем байт в " -"`EDX`, потому что нам нужно преобразовать верхние четыре бита (ниббл) " -"отдельно от нижних четырёх битов. Результат сохраняется в первых двух байтах " -"буфера." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:706 -msgid "" -"Next, we ask the system to write the three bytes of the buffer, i.e., the " -"two hexadecimal digits and the blank space, to [.filename]#stdout#. We then " -"jump back to the beginning of the program and process the next byte." -msgstr "" -"Далее мы просим систему записать три байта буфера, то есть две " -"шестнадцатеричные цифры и пробел, в [.filename]#stdout#. Затем мы " -"возвращаемся к началу программы и обрабатываем следующий байт." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:708 -msgid "" -"Once there is no more input left, we ask the system to exit our program, " -"returning a zero, which is the traditional value meaning the program was " -"successful." -msgstr "" -"Когда ввод больше не остаётся, мы просим систему завершить нашу программу, " -"возвращая ноль, что традиционно означает успешное выполнение программы." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:710 -msgid "" -"Go ahead, and save the code in a file named [.filename]#hex.asm#, then type " -"the following (the `^D` means press the control key and type `D` while " -"holding the control key down):" -msgstr "" -"Продолжайте и сохраните код в файле с именем [.filename]#hex.asm#, затем " -"введите следующее (символ `^D` означает, что нужно нажать клавишу управления " -"и, удерживая её, ввести `D`):" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:719 -#, no-wrap -msgid "" -"% nasm -f elf hex.asm\n" -"% ld -s -o hex hex.o\n" -"% ./hex\n" -"Hello, World!\n" -"48 65 6C 6C 6F 2C 20 57 6F 72 6C 64 21 0A Here I come!\n" -"48 65 72 65 20 49 20 63 6F 6D 65 21 0A ^D %\n" -msgstr "" -"% nasm -f elf hex.asm\n" -"% ld -s -o hex hex.o\n" -"% ./hex\n" -"Hello, World!\n" -"48 65 6C 6C 6F 2C 20 57 6F 72 6C 64 21 0A Here I come!\n" -"48 65 72 65 20 49 20 63 6F 6D 65 21 0A ^D %\n" - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:725 -msgid "" -"If you are migrating to UNIX(R) from MS-DOS(R), you may be wondering why " -"each line ends with `0A` instead of `0D 0A`. This is because UNIX(R) does " -"not use the cr/lf convention, but a \"new line\" convention, which is `0A` " -"in hexadecimal." -msgstr "" -"Если вы переходите на UNIX(R) с MS-DOS(R), вам может быть интересно, почему " -"каждая строка заканчивается на `0A` вместо `0D 0A`. Это связано с тем, что " -"UNIX(R) не использует соглашение cr/lf, а использует соглашение \"новая " -"строка\", которое в шестнадцатеричном виде представлено как `0A`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:730 -msgid "" -"Can we improve this? Well, for one, it is a bit confusing because once we " -"have converted a line of text, our input no longer starts at the beginning " -"of the line. We can modify it to print a new line instead of a space after " -"each `0A`:" -msgstr "" -"Можем ли мы это улучшить? Что ж, во-первых, это немного запутанно, потому " -"что после преобразования строки текста наш ввод больше не начинается с " -"начала строки. Мы можем изменить это, чтобы после каждого `0A` выводилась " -"новая строка вместо пробела:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:743 -#, no-wrap -msgid "" -"section\t.text\n" -"global\t_start\n" -"_start:\n" -"\tmov\tcl, ' '\n" -msgstr "" -"section\t.text\n" -"global\t_start\n" -"_start:\n" -"\tmov\tcl, ' '\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:753 -#, no-wrap -msgid "" -".loop:\n" -"\t; read a byte from stdin\n" -"\tpush\tdword 1\n" -"\tpush\tdword buffer\n" -"\tpush\tdword stdin\n" -"\tsys.read\n" -"\tadd\tesp, byte 12\n" -"\tor\teax, eax\n" -"\tje\t.done\n" -msgstr "" -".loop:\n" -"\t; read a byte from stdin\n" -"\tpush\tdword 1\n" -"\tpush\tdword buffer\n" -"\tpush\tdword stdin\n" -"\tsys.read\n" -"\tadd\tesp, byte 12\n" -"\tor\teax, eax\n" -"\tje\t.done\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:760 -#, no-wrap -msgid "" -"\t; convert it to hex\n" -"\tmovzx\teax, byte [buffer]\n" -"\tmov\t[buffer+2], cl\n" -"\tcmp\tal, 0Ah\n" -"\tjne\t.hex\n" -"\tmov\t[buffer+2], al\n" -msgstr "" -"\t; convert it to hex\n" -"\tmovzx\teax, byte [buffer]\n" -"\tmov\t[buffer+2], cl\n" -"\tcmp\tal, 0Ah\n" -"\tjne\t.hex\n" -"\tmov\t[buffer+2], al\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:769 -#, no-wrap -msgid "" -".hex:\n" -"\tmov\tedx, eax\n" -"\tshr\tdl, 4\n" -"\tmov\tdl, [hex+edx]\n" -"\tmov\t[buffer], dl\n" -"\tand\tal, 0Fh\n" -"\tmov\tal, [hex+eax]\n" -"\tmov\t[buffer+1], al\n" -msgstr "" -".hex:\n" -"\tmov\tedx, eax\n" -"\tshr\tdl, 4\n" -"\tmov\tdl, [hex+edx]\n" -"\tmov\t[buffer], dl\n" -"\tand\tal, 0Fh\n" -"\tmov\tal, [hex+eax]\n" -"\tmov\t[buffer+1], al\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:777 -#, no-wrap -msgid "" -"\t; print it\n" -"\tpush\tdword 3\n" -"\tpush\tdword buffer\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -"\tadd\tesp, byte 12\n" -"\tjmp\tshort .loop\n" -msgstr "" -"\t; print it\n" -"\tpush\tdword 3\n" -"\tpush\tdword buffer\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -"\tadd\tesp, byte 12\n" -"\tjmp\tshort .loop\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:785 -msgid "" -"We have stored the space in the `CL` register. We can do this safely " -"because, unlike Microsoft(R) Windows(R), UNIX(R) system calls do not modify " -"the value of any register they do not use to return a value in." -msgstr "" -"Мы сохранили пробел в регистре `CL`. Это безопасно, потому что, в отличие от " -"Microsoft(R) Windows(R), вызовы системы UNIX(R) не изменяют значение " -"регистров, которые не используются для возврата значения." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:789 -msgid "" -"That means we only need to set `CL` once. We have, therefore, added a new " -"label `.loop` and jump to it for the next byte instead of jumping at " -"`_start`. We have also added the `.hex` label so we can either have a blank " -"space or a new line as the third byte of the `buffer`." -msgstr "" -"Это означает, что нам нужно установить `CL` только один раз. Поэтому мы " -"добавили новую метку `.loop` и переходим к ней для следующего байта вместо " -"перехода к `_start`. Мы также добавили метку `.hex`, чтобы третий байт " -"`buffer` мог быть либо пробелом, либо новой строкой." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:791 -msgid "" -"Once you have changed [.filename]#hex.asm# to reflect these changes, type:" -msgstr "После внесения изменений в файл [.filename]#hex.asm# введите:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:802 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1061 -#, no-wrap -msgid "" -"% nasm -f elf hex.asm\n" -"% ld -s -o hex hex.o\n" -"% ./hex\n" -"Hello, World!\n" -"48 65 6C 6C 6F 2C 20 57 6F 72 6C 64 21 0A\n" -"Here I come!\n" -"48 65 72 65 20 49 20 63 6F 6D 65 21 0A\n" -"^D %\n" -msgstr "" -"% nasm -f elf hex.asm\n" -"% ld -s -o hex hex.o\n" -"% ./hex\n" -"Hello, World!\n" -"48 65 6C 6C 6F 2C 20 57 6F 72 6C 64 21 0A\n" -"Here I come!\n" -"48 65 72 65 20 49 20 63 6F 6D 65 21 0A\n" -"^D %\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:806 -msgid "" -"That looks better. But this code is quite inefficient! We are making a " -"system call for every single byte twice (once to read it, another time to " -"write the output)." -msgstr "" -"Выглядит лучше. Но этот код довольно неэффективен! Мы выполняем системный " -"вызов для каждого отдельного байта дважды (один раз для чтения и ещё один " -"для записи вывода)." - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:808 -#, no-wrap -msgid "Buffered Input and Output" -msgstr "Буферизованный ввод и вывод" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:813 -msgid "" -"We can improve the efficiency of our code by buffering our input and " -"output. We create an input buffer and read a whole sequence of bytes at one " -"time. Then we fetch them one by one from the buffer." -msgstr "" -"Мы можем повысить эффективность нашего кода, буферизуя ввод и вывод. Мы " -"создаём входной буфер и читаем сразу целую последовательность байтов. Затем " -"мы извлекаем их по одному из буфера." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:816 -msgid "" -"We also create an output buffer. We store our output in it until it is " -"full. At that time we ask the kernel to write the contents of the buffer to " -"[.filename]#stdout#." -msgstr "" -"Мы также создаем выходной буфер. Мы сохраняем наш вывод в нём, пока он не " -"заполнится. В этот момент мы просим ядро записать содержимое буфера в [." -"filename]#stdout#." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:820 -msgid "" -"The program ends when there is no more input. But we still need to ask the " -"kernel to write the contents of our output buffer to [.filename]#stdout# one " -"last time, otherwise some of our output would make it to the output buffer, " -"but never be sent out. Do not forget that, or you will be wondering why " -"some of your output is missing." -msgstr "" -"Программа завершается, когда больше нет входных данных. Но нам всё ещё нужно " -"попросить ядро записать содержимое нашего выходного буфера в [." -"filename]#stdout# в последний раз, иначе часть нашего вывода попадёт в " -"буфер, но так и не будет отправлена. Не забудьте об этом, иначе будете " -"недоумевать, куда пропала часть вывода." - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:826 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:954 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1221 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2339 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3337 -#, no-wrap -msgid "%define\tBUFSIZE\t2048\n" -msgstr "%define\tBUFSIZE\t2048\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:829 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:957 -#, no-wrap -msgid "" -"section\t.data\n" -"hex\tdb\t'0123456789ABCDEF'\n" -msgstr "" -"section\t.data\n" -"hex\tdb\t'0123456789ABCDEF'\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:833 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:961 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1230 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2353 -#, no-wrap -msgid "" -"section .bss\n" -"ibuffer\tresb\tBUFSIZE\n" -"obuffer\tresb\tBUFSIZE\n" -msgstr "" -"section .bss\n" -"ibuffer\tresb\tBUFSIZE\n" -"obuffer\tresb\tBUFSIZE\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:841 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:969 -#, no-wrap -msgid "" -"section\t.text\n" -"global\t_start\n" -"_start:\n" -"\tsub\teax, eax\n" -"\tsub\tebx, ebx\n" -"\tsub\tecx, ecx\n" -"\tmov\tedi, obuffer\n" -msgstr "" -"section\t.text\n" -"global\t_start\n" -"_start:\n" -"\tsub\teax, eax\n" -"\tsub\tebx, ebx\n" -"\tsub\tecx, ecx\n" -"\tmov\tedi, obuffer\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:845 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:973 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2501 -#, no-wrap -msgid "" -".loop:\n" -"\t; read a byte from stdin\n" -"\tcall\tgetchar\n" -msgstr "" -".loop:\n" -"\t; read a byte from stdin\n" -"\tcall\tgetchar\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:851 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:979 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1283 -#, no-wrap -msgid "" -"\t; convert it to hex\n" -"\tmov\tdl, al\n" -"\tshr\tal, 4\n" -"\tmov\tal, [hex+eax]\n" -"\tcall\tputchar\n" -msgstr "" -"\t; convert it to hex\n" -"\tmov\tdl, al\n" -"\tshr\tal, 4\n" -"\tmov\tal, [hex+eax]\n" -"\tcall\tputchar\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:856 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:984 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1288 -#, no-wrap -msgid "" -"\tmov\tal, dl\n" -"\tand\tal, 0Fh\n" -"\tmov\tal, [hex+eax]\n" -"\tcall\tputchar\n" -msgstr "" -"\tmov\tal, dl\n" -"\tand\tal, 0Fh\n" -"\tmov\tal, [hex+eax]\n" -"\tcall\tputchar\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:861 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:989 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1293 -#, no-wrap -msgid "" -"\tmov\tal, ' '\n" -"\tcmp\tdl, 0Ah\n" -"\tjne\t.put\n" -"\tmov\tal, dl\n" -msgstr "" -"\tmov\tal, ' '\n" -"\tcmp\tdl, 0Ah\n" -"\tjne\t.put\n" -"\tmov\tal, dl\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:865 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2512 -#, no-wrap -msgid "" -".put:\n" -"\tcall\tputchar\n" -"\tjmp\tshort .loop\n" -msgstr "" -".put:\n" -"\tcall\tputchar\n" -"\tjmp\tshort .loop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:870 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1001 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1305 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2534 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3848 -#, no-wrap -msgid "" -"align 4\n" -"getchar:\n" -"\tor\tebx, ebx\n" -"\tjne\t.fetch\n" -msgstr "" -"align 4\n" -"getchar:\n" -"\tor\tebx, ebx\n" -"\tjne\t.fetch\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:872 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1003 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1307 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2536 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3850 -#, no-wrap -msgid "\tcall\tread\n" -msgstr "\tcall\tread\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:877 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1008 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1312 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2541 -#, no-wrap -msgid "" -".fetch:\n" -"\tlodsb\n" -"\tdec\tebx\n" -"\tret\n" -msgstr "" -".fetch:\n" -"\tlodsb\n" -"\tdec\tebx\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:890 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1021 -#, no-wrap -msgid "" -"read:\n" -"\tpush\tdword BUFSIZE\n" -"\tmov\tesi, ibuffer\n" -"\tpush\tesi\n" -"\tpush\tdword stdin\n" -"\tsys.read\n" -"\tadd\tesp, byte 12\n" -"\tmov\tebx, eax\n" -"\tor\teax, eax\n" -"\tje\t.done\n" -"\tsub\teax, eax\n" -"\tret\n" -msgstr "" -"read:\n" -"\tpush\tdword BUFSIZE\n" -"\tmov\tesi, ibuffer\n" -"\tpush\tesi\n" -"\tpush\tdword stdin\n" -"\tsys.read\n" -"\tadd\tesp, byte 12\n" -"\tmov\tebx, eax\n" -"\tor\teax, eax\n" -"\tje\t.done\n" -"\tsub\teax, eax\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:896 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1027 -#, no-wrap -msgid "" -"align 4\n" -".done:\n" -"\tcall\twrite\t\t; flush output buffer\n" -"\tpush\tdword 0\n" -"\tsys.exit\n" -msgstr "" -"align 4\n" -".done:\n" -"\tcall\twrite\t\t; flush output buffer\n" -"\tpush\tdword 0\n" -"\tsys.exit\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:904 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1035 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1348 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2581 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3887 -#, no-wrap -msgid "" -"align 4\n" -"putchar:\n" -"\tstosb\n" -"\tinc\tecx\n" -"\tcmp\tecx, BUFSIZE\n" -"\tje\twrite\n" -"\tret\n" -msgstr "" -"align 4\n" -"putchar:\n" -"\tstosb\n" -"\tinc\tecx\n" -"\tcmp\tecx, BUFSIZE\n" -"\tje\twrite\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:916 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1047 -#, no-wrap -msgid "" -"align 4\n" -"write:\n" -"\tsub\tedi, ecx\t; start of buffer\n" -"\tpush\tecx\n" -"\tpush\tedi\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -"\tadd\tesp, byte 12\n" -"\tsub\teax, eax\n" -"\tsub\tecx, ecx\t; buffer is empty now\n" -"\tret\n" -msgstr "" -"align 4\n" -"write:\n" -"\tsub\tedi, ecx\t; start of buffer\n" -"\tpush\tecx\n" -"\tpush\tedi\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -"\tadd\tesp, byte 12\n" -"\tsub\teax, eax\n" -"\tsub\tecx, ecx\t; buffer is empty now\n" -"\tret\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:922 -msgid "" -"We now have a third section in the source code, named `.bss`. This section " -"is not included in our executable file, and, therefore, cannot be " -"initialized. We use `resb` instead of `db`. It simply reserves the " -"requested size of uninitialized memory for our use." -msgstr "" -"Теперь у нас есть третий раздел в исходном коде с именем `.bss`. Этот раздел " -"не включается в исполняемый файл и, следовательно, не может быть " -"инициализирован. Мы используем `resb` вместо `db`. Это просто резервирует " -"запрошенный размер неинициализированной памяти для нашего использования." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:926 -msgid "" -"We take advantage of the fact that the system does not modify the registers: " -"We use registers for what, otherwise, would have to be global variables " -"stored in the `.data` section. This is also why the UNIX(R) convention of " -"passing parameters to system calls on the stack is superior to the Microsoft " -"convention of passing them in the registers: We can keep the registers for " -"our own use." -msgstr "" -"Мы используем тот факт, что система не изменяет регистры: мы используем " -"регистры для того, что в противном случае пришлось бы хранить в глобальных " -"переменных в секции `.data`. Именно поэтому соглашение UNIX(R) о передаче " -"параметров системных вызовов через стек превосходит соглашение Microsoft о " -"передаче их в регистрах: мы можем оставить регистры для собственного " -"использования." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:930 -msgid "" -"We use `EDI` and `ESI` as pointers to the next byte to be read from or " -"written to. We use `EBX` and `ECX` to keep count of the number of bytes in " -"the two buffers, so we know when to dump the output to, or read more input " -"from, the system." -msgstr "" -"Мы используем `EDI` и `ESI` как указатели на следующий байт для чтения или " -"записи. Мы используем `EBX` и `ECX` для отслеживания количества байтов в " -"двух буферах, чтобы знать, когда нужно вывести данные в систему или считать " -"новые данные из системы." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:932 -msgid "Let us see how it works now:" -msgstr "Давайте посмотрим, как это работает сейчас:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:943 -#, no-wrap -msgid "" -"% nasm -f elf hex.asm\n" -"% ld -s -o hex hex.o\n" -"% ./hex\n" -"Hello, World!\n" -"Here I come!\n" -"48 65 6C 6C 6F 2C 20 57 6F 72 6C 64 21 0A\n" -"48 65 72 65 20 49 20 63 6F 6D 65 21 0A\n" -"^D %\n" -msgstr "" -"% nasm -f elf hex.asm\n" -"% ld -s -o hex hex.o\n" -"% ./hex\n" -"Hello, World!\n" -"Here I come!\n" -"48 65 6C 6C 6F 2C 20 57 6F 72 6C 64 21 0A\n" -"48 65 72 65 20 49 20 63 6F 6D 65 21 0A\n" -"^D %\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:948 -msgid "" -"Not what you expected? The program did not print the output until we pressed " -"`^D`. That is easy to fix by inserting three lines of code to write the " -"output every time we have converted a new line to `0A`. I have marked the " -"three lines with > (do not copy the > in your [.filename]#hex.asm#)." -msgstr "" -"Не то, что вы ожидали? Программа не выводила результат, пока мы не нажали " -"`^D`. Это легко исправить, добавив три строки кода для вывода результата " -"каждый раз, когда мы преобразуем новую строку в `0A`. Я пометил эти три " -"строки символом > (не копируйте > в ваш [.filename]#hex.asm#)." - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:996 -#, no-wrap -msgid "" -".put:\n" -"\tcall\tputchar\n" -">\tcmp\tal, 0Ah\n" -">\tjne\t.loop\n" -">\tcall\twrite\n" -"\tjmp\tshort .loop\n" -msgstr "" -".put:\n" -"\tcall\tputchar\n" -">\tcmp\tal, 0Ah\n" -">\tjne\t.loop\n" -">\tcall\twrite\n" -"\tjmp\tshort .loop\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1050 -msgid "Now, let us see how it works:" -msgstr "Теперь давайте посмотрим, как это работает:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1064 -msgid "Not bad for a 644-byte executable, is it!" -msgstr "Неплохо для исполняемого файла размером 644 байта, не так ли!" - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1069 -msgid "" -"This approach to buffered input/output still contains a hidden danger. I " -"will discuss-and fix-it later, when I talk about the crossref:x86[x86-" -"buffered-dark-side,dark side of buffering]." -msgstr "" -"Такой подход к буферизированному вводу/выводу всё ещё содержит скрытую " -"опасность. Я расскажу об этом и исправлю её позже, когда речь пойдёт о " -"crossref:x86[x86-buffered-dark-side,тёмной стороне буферизации]." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1072 -#, no-wrap -msgid "How to Unread a Character" -msgstr "Как отменить чтение символа" - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1078 -msgid "" -"This may be a somewhat advanced topic, mostly of interest to programmers " -"familiar with the theory of compilers. If you wish, you may crossref:" -"x86[x86-command-line,skip to the next section], and perhaps read this later." -msgstr "" -"Это может быть несколько сложной темой, в основном представляющей интерес " -"для программистов, знакомых с теорией компиляторов. Если хотите, вы можете " -"crossref:x86[x86-command-line, перейти к следующему разделу], и, возможно, " -"прочитаете это позже." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1084 -msgid "" -"While our sample program does not require it, more sophisticated filters " -"often need to look ahead. In other words, they may need to see what the " -"next character is (or even several characters). If the next character is of " -"a certain value, it is part of the token currently being processed. " -"Otherwise, it is not." -msgstr "" -"Хотя наш пример программы не требует этого, более сложные фильтры часто " -"нуждаются в предварительном просмотре. Другими словами, им может " -"потребоваться узнать, какой следующий символ (или даже несколько символов). " -"Если следующий символ имеет определённое значение, он является частью " -"текущего обрабатываемого токена. В противном случае — нет." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1088 -msgid "" -"For example, you may be parsing the input stream for a textual string (e.g., " -"when implementing a language compiler): If a character is followed by " -"another character, or perhaps a digit, it is part of the token you are " -"processing. If it is followed by white space, or some other value, then it " -"is not part of the current token." -msgstr "" -"Например, вы можете анализировать входной поток на наличие текстовой строки " -"(например, при реализации компилятора языка): если символ следует за другим " -"символом или, возможно, цифрой, он является частью обрабатываемой лексемы. " -"Если за ним следует пробел или другое значение, то он не является частью " -"текущей лексемы." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1090 -msgid "" -"This presents an interesting problem: How to return the next character back " -"to the input stream, so it can be read again later?" -msgstr "" -"Это представляет интересную проблему: как вернуть следующий символ обратно " -"во входной поток, чтобы его можно было прочитать позже?" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1094 -msgid "" -"One possible solution is to store it in a character variable, then set a " -"flag. We can modify `getchar` to check the flag, and if it is set, fetch " -"the byte from that variable instead of the input buffer, and reset the " -"flag. But, of course, that slows us down." -msgstr "" -"Одно из возможных решений — сохранить его в символьной переменной, а затем " -"установить флаг. Мы можем изменить `getchar`, чтобы он проверял флаг, и если " -"он установлен, извлекал байт из этой переменной вместо буфера ввода, а затем " -"сбрасывал флаг. Но, конечно, это замедляет работу." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1099 -msgid "" -"The C language has an `ungetc()` function, just for that purpose. Is there " -"a quick way to implement it in our code? I would like you to scroll back up " -"and take a look at the `getchar` procedure and see if you can find a nice " -"and fast solution before reading the next paragraph. Then come back here " -"and see my own solution." -msgstr "" -"В языке C есть функция `ungetc()`, как раз для этой цели. Есть ли быстрый " -"способ реализовать её в нашем коде? Я хочу, чтобы вы пролистали назад и " -"взглянули на процедуру `getchar`, и попробовали найти красивое и быстрое " -"решение, прежде чем читать следующий абзац. Затем вернитесь сюда и " -"посмотрите моё собственное решение." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1101 -msgid "" -"The key to returning a character back to the stream is in how we are getting " -"the characters to start with:" -msgstr "" -"Ключом к возвращению символа обратно в поток является то, как мы получаем " -"символы изначально:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1104 -msgid "" -"First we check if the buffer is empty by testing the value of `EBX`. If it " -"is zero, we call the `read` procedure." -msgstr "" -"Сначала проверяем, пуст ли буфер, проверяя значение `EBX`. Если оно равно " -"нулю, вызываем процедуру `read`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1107 -msgid "" -"If we do have a character available, we use `lodsb`, then decrease the value " -"of `EBX`. The `lodsb` instruction is effectively identical to:" -msgstr "" -"Если у нас есть доступный символ, мы используем `lodsb`, затем уменьшаем " -"значение `EBX`. Инструкция `lodsb` фактически идентична:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1112 -#, no-wrap -msgid "" -"mov\tal, [esi]\n" -"\tinc\tesi\n" -msgstr "" -"mov\tal, [esi]\n" -"\tinc\tesi\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1117 -msgid "" -"The byte we have fetched remains in the buffer until the next time `read` is " -"called. We do not know when that happens, but we do know it will not happen " -"until the next call to `getchar`. Hence, to \"return\" the last-read byte " -"back to the stream, all we have to do is decrease the value of `ESI` and " -"increase the value of `EBX`:" -msgstr "" -"Байт, который мы извлекли, остаётся в буфере до следующего вызова `read`. Мы " -"не знаем, когда это произойдет, но знаем, что этого не случится до " -"следующего вызова `getchar`. Следовательно, чтобы \"вернуть\" последний " -"прочитанный байт обратно в поток, нам достаточно уменьшить значение `ESI` и " -"увеличить значение `EBX`:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1124 -#, no-wrap -msgid "" -"ungetc:\n" -"\tdec\tesi\n" -"\tinc\tebx\n" -"\tret\n" -msgstr "" -"ungetc:\n" -"\tdec\tesi\n" -"\tinc\tebx\n" -"\tret\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1128 -msgid "" -"But, be careful! We are perfectly safe doing this if our look-ahead is at " -"most one character at a time. If we are examining more than one upcoming " -"character and call `ungetc` several times in a row, it will work most of the " -"time, but not all the time (and will be tough to debug). Why?" -msgstr "" -"Но будьте осторожны! Мы в полной безопасности, если заглядываем вперёд " -"только на один символ за раз. Если же мы проверяем несколько следующих " -"символов и вызываем `ungetc` несколько раз подряд, это будет работать в " -"большинстве случаев, но не всегда (и ошибки будет сложно отладить). Почему?" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1131 -msgid "" -"Because as long as `getchar` does not have to call `read`, all of the pre-" -"read bytes are still in the buffer, and our `ungetc` works without a " -"glitch. But the moment `getchar` calls `read`, the contents of the buffer " -"change." -msgstr "" -"Потому что пока `getchar` не вызывает `read`, все предварительно прочитанные " -"байты остаются в буфере, и наш `ungetc` работает без сбоев. Но как только " -"`getchar` вызывает `read`, содержимое буфера изменяется." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1133 -msgid "" -"We can always rely on `ungetc` working properly on the last character we " -"have read with `getchar`, but not on anything we have read before that." -msgstr "" -"Мы всегда можем рассчитывать на корректную работу `ungetc` с последним " -"символом, прочитанным через `getchar`, но не с любым символом, прочитанным " -"до этого." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1135 -msgid "" -"If your program reads more than one byte ahead, you have at least two " -"choices:" -msgstr "" -"Если ваша программа читает более одного байта вперёд, у вас есть как минимум " -"два варианта:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1138 -msgid "" -"If possible, modify the program so it only reads one byte ahead. This is " -"the simplest solution." -msgstr "" -"Если возможно, измените программу так, чтобы она читала только один байт " -"вперёд. Это самое простое решение." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1142 -msgid "" -"If that option is not available, first of all determine the maximum number " -"of characters your program needs to return to the input stream at one time. " -"Increase that number slightly, just to be sure, preferably to a multiple of " -"16-so it aligns nicely. Then modify the `.bss` section of your code, and " -"create a small \"spare\" buffer right before your input buffer, something " -"like this:" -msgstr "" -"Если эта опция недоступна, сначала определите максимальное количество " -"символов, которое вашей программе может потребоваться вернуть во входной " -"поток за один раз. Увеличьте это число немного, чтобы быть уверенным, " -"предпочтительно до кратного 16 — так оно будет лучше выровнено. Затем " -"измените секцию `.bss` в вашем коде и создайте небольшой \"запасной\" буфер " -"прямо перед вашим входным буфером, примерно так:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1149 -#, no-wrap -msgid "" -"section\t.bss\n" -"\tresb\t16\t; or whatever the value you came up with\n" -"ibuffer\tresb\tBUFSIZE\n" -"obuffer\tresb\tBUFSIZE\n" -msgstr "" -"section\t.bss\n" -"\tresb\t16\t; or whatever the value you came up with\n" -"ibuffer\tresb\tBUFSIZE\n" -"obuffer\tresb\tBUFSIZE\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1152 -msgid "" -"You also need to modify your `ungetc` to pass the value of the byte to unget " -"in `AL`:" -msgstr "" -"Вам также необходимо изменить ваш `ungetc`, чтобы передать значение байта " -"для возврата в `AL`:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1160 -#, no-wrap -msgid "" -"ungetc:\n" -"\tdec\tesi\n" -"\tinc\tebx\n" -"\tmov\t[esi], al\n" -"\tret\n" -msgstr "" -"ungetc:\n" -"\tdec\tesi\n" -"\tinc\tebx\n" -"\tmov\t[esi], al\n" -"\tret\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1163 -msgid "" -"With this modification, you can call `ungetc` up to 17 times in a row safely " -"(the first call will still be within the buffer, the remaining 16 may be " -"either within the buffer or within the \"spare\")." -msgstr "" -"С этим изменением вы можете безопасно вызывать `ungetc` до 17 раз подряд " -"(первый вызов всё ещё будет в пределах буфера, остальные 16 могут быть либо " -"в пределах буфера, либо в пределах \"запасного\" пространства)." - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1165 -#, no-wrap -msgid "Command Line Arguments" -msgstr "Аргументы командной строки" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1169 -msgid "" -"Our hex program will be more useful if it can read the names of an input and " -"output file from its command line, i.e., if it can process the command line " -"arguments. But... Where are they?" -msgstr "" -"Наша программа hex будет полезнее, если она сможет читать имена входного и " -"выходного файлов из командной строки, т.е. если она сможет обрабатывать " -"аргументы командной строки. Но... Где они?" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1173 -msgid "" -"Before a UNIX(R) system starts a program, it ``push``es some data on the " -"stack, then jumps at the `_start` label of the program. Yes, I said jumps, " -"not calls. That means the data can be accessed by reading `[esp+offset]`, " -"or by simply ``pop``ping it." -msgstr "" -"Прежде чем UNIX(R) система запустит программу, она делает ``push`` для " -"некоторых данных, помещая их в стек, затем переходит к метке `_start` " -"программы. Да, я сказал \"переходит\", а не \"вызывает\". Это означает, что " -"данные можно прочитать с помощью `[esp+offset]` или просто сделать ``pop`` " -"для них." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1176 -msgid "" -"The value at the top of the stack contains the number of command line " -"arguments. It is traditionally called `argc`, for \"argument count.\"" -msgstr "" -"Значение на вершине стека содержит количество аргументов командной строки. " -"Оно традиционно называется `argc`, что означает \"argument count\"." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1181 -msgid "" -"Command line arguments follow next, all `argc` of them. These are typically " -"referred to as `argv`, for \"argument value(s).\" That is, we get `argv[0]`, " -"`argv[1]`, `...`, `argv[argc-1]`. These are not the actual arguments, but " -"pointers to arguments, i.e., memory addresses of the actual arguments. The " -"arguments themselves are NUL-terminated character strings." -msgstr "" -"Далее следуют аргументы командной строки, все `argc` штук. Обычно их " -"называют `argv`, что означает \"значение(я) аргумента\". То есть мы получаем " -"`argv[0]`, `argv[1]`, `...`, `argv[argc-1]`. Это не сами аргументы, а " -"указатели на аргументы, то есть адреса памяти, где находятся реальные " -"аргументы. Сами аргументы представляют собой строки символов, завершающиеся " -"нулевым символом ('\\0')." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1183 -msgid "" -"The `argv` list is followed by a NULL pointer, which is simply a `0`. There " -"is more, but this is enough for our purposes right now." -msgstr "" -"Список `argv` завершается указателем NULL, который представляет собой просто " -"`0`. Есть и другие детали, но пока этого достаточно для наших целей." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1188 -msgid "" -"If you have come from the MS-DOS(R) programming environment, the main " -"difference is that each argument is in a separate string. The second " -"difference is that there is no practical limit on how many arguments there " -"can be." -msgstr "" -"Если вы перешли из среды программирования MS-DOS(R), основное различие " -"заключается в том, что каждый аргумент находится в отдельной строке. Второе " -"различие состоит в том, что нет практического ограничения на количество " -"аргументов." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1192 -msgid "" -"Armed with this knowledge, we are almost ready for the next version of [." -"filename]#hex.asm#. First, however, we need to add a few lines to [." -"filename]#system.inc#:" -msgstr "" -"Вооружившись этими знаниями, мы почти готовы к следующей версии [." -"filename]#hex.asm#. Однако сначала нам нужно добавить несколько строк в [." -"filename]#system.inc#:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1194 -msgid "" -"First, we need to add two new entries to our list of system call numbers:" -msgstr "" -"Сначала нам нужно добавить две новые записи в наш список номеров системных " -"вызовов:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1199 -#, no-wrap -msgid "" -"%define\tSYS_open\t5\n" -"%define\tSYS_close\t6\n" -msgstr "" -"%define\tSYS_open\t5\n" -"%define\tSYS_close\t6\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1202 -msgid "Then we add two new macros at the end of the file:" -msgstr "Затем мы добавляем два новых макроса в конце файла:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1208 -#, no-wrap -msgid "" -"%macro\tsys.open\t0\n" -"\tsystem\tSYS_open\n" -"%endmacro\n" -msgstr "" -"%macro\tsys.open\t0\n" -"\tsystem\tSYS_open\n" -"%endmacro\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1212 -#, no-wrap -msgid "" -"%macro\tsys.close\t0\n" -"\tsystem\tSYS_close\n" -"%endmacro\n" -msgstr "" -"%macro\tsys.close\t0\n" -"\tsystem\tSYS_close\n" -"%endmacro\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1215 -msgid "Here, then, is our modified source code:" -msgstr "Вот наш измененный исходный код:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1226 -#, no-wrap -msgid "" -"section\t.data\n" -"fd.in\tdd\tstdin\n" -"fd.out\tdd\tstdout\n" -"hex\tdb\t'0123456789ABCDEF'\n" -msgstr "" -"section\t.data\n" -"fd.in\tdd\tstdin\n" -"fd.out\tdd\tstdout\n" -"hex\tdb\t'0123456789ABCDEF'\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1236 -#, no-wrap -msgid "" -"section\t.text\n" -"align 4\n" -"err:\n" -"\tpush\tdword 1\t\t; return failure\n" -"\tsys.exit\n" -msgstr "" -"section\t.text\n" -"align 4\n" -"err:\n" -"\tpush\tdword 1\t\t; return failure\n" -"\tsys.exit\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1241 -#, no-wrap -msgid "" -"align 4\n" -"global\t_start\n" -"_start:\n" -"\tadd\tesp, byte 8\t; discard argc and argv[0]\n" -msgstr "" -"align 4\n" -"global\t_start\n" -"_start:\n" -"\tadd\tesp, byte 8\t; discard argc and argv[0]\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1244 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1256 -#, no-wrap -msgid "" -"\tpop\tecx\n" -"\tjecxz\t.init\t\t; no more arguments\n" -msgstr "" -"\tpop\tecx\n" -"\tjecxz\t.init\t\t; no more arguments\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1250 -#, no-wrap -msgid "" -"\t; ECX contains the path to input file\n" -"\tpush\tdword 0\t\t; O_RDONLY\n" -"\tpush\tecx\n" -"\tsys.open\n" -"\tjc\terr\t\t; open failed\n" -msgstr "" -"\t; ECX contains the path to input file\n" -"\tpush\tdword 0\t\t; O_RDONLY\n" -"\tpush\tecx\n" -"\tsys.open\n" -"\tjc\terr\t\t; open failed\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1253 -#, no-wrap -msgid "" -"\tadd\tesp, byte 8\n" -"\tmov\t[fd.in], eax\n" -msgstr "" -"\tadd\tesp, byte 8\n" -"\tmov\t[fd.in], eax\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1264 -#, no-wrap -msgid "" -"\t; ECX contains the path to output file\n" -"\tpush\tdword 420\t; file mode (644 octal)\n" -"\tpush\tdword 0200h | 0400h | 01h\n" -"\t; O_CREAT | O_TRUNC | O_WRONLY\n" -"\tpush\tecx\n" -"\tsys.open\n" -"\tjc\terr\n" -msgstr "" -"\t; ECX contains the path to output file\n" -"\tpush\tdword 420\t; file mode (644 octal)\n" -"\tpush\tdword 0200h | 0400h | 01h\n" -"\t; O_CREAT | O_TRUNC | O_WRONLY\n" -"\tpush\tecx\n" -"\tsys.open\n" -"\tjc\terr\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1267 -#, no-wrap -msgid "" -"\tadd\tesp, byte 12\n" -"\tmov\t[fd.out], eax\n" -msgstr "" -"\tadd\tesp, byte 12\n" -"\tmov\t[fd.out], eax\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1273 -#, no-wrap -msgid "" -".init:\n" -"\tsub\teax, eax\n" -"\tsub\tebx, ebx\n" -"\tsub\tecx, ecx\n" -"\tmov\tedi, obuffer\n" -msgstr "" -".init:\n" -"\tsub\teax, eax\n" -"\tsub\tebx, ebx\n" -"\tsub\tecx, ecx\n" -"\tmov\tedi, obuffer\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1277 -#, no-wrap -msgid "" -".loop:\n" -"\t; read a byte from input file or stdin\n" -"\tcall\tgetchar\n" -msgstr "" -".loop:\n" -"\t; read a byte from input file or stdin\n" -"\tcall\tgetchar\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1300 -#, no-wrap -msgid "" -".put:\n" -"\tcall\tputchar\n" -"\tcmp\tal, dl\n" -"\tjne\t.loop\n" -"\tcall\twrite\n" -"\tjmp\tshort .loop\n" -msgstr "" -".put:\n" -"\tcall\tputchar\n" -"\tcmp\tal, dl\n" -"\tjne\t.loop\n" -"\tcall\twrite\n" -"\tjmp\tshort .loop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1325 -#, no-wrap -msgid "" -"read:\n" -"\tpush\tdword BUFSIZE\n" -"\tmov\tesi, ibuffer\n" -"\tpush\tesi\n" -"\tpush\tdword [fd.in]\n" -"\tsys.read\n" -"\tadd\tesp, byte 12\n" -"\tmov\tebx, eax\n" -"\tor\teax, eax\n" -"\tje\t.done\n" -"\tsub\teax, eax\n" -"\tret\n" -msgstr "" -"read:\n" -"\tpush\tdword BUFSIZE\n" -"\tmov\tesi, ibuffer\n" -"\tpush\tesi\n" -"\tpush\tdword [fd.in]\n" -"\tsys.read\n" -"\tadd\tesp, byte 12\n" -"\tmov\tebx, eax\n" -"\tor\teax, eax\n" -"\tje\t.done\n" -"\tsub\teax, eax\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1329 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2562 -#, no-wrap -msgid "" -"align 4\n" -".done:\n" -"\tcall\twrite\t\t; flush output buffer\n" -msgstr "" -"align 4\n" -".done:\n" -"\tcall\twrite\t\t; flush output buffer\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1333 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2566 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3820 -#, no-wrap -msgid "" -"\t; close files\n" -"\tpush\tdword [fd.in]\n" -"\tsys.close\n" -msgstr "" -"\t; close files\n" -"\tpush\tdword [fd.in]\n" -"\tsys.close\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1336 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2569 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3823 -#, no-wrap -msgid "" -"\tpush\tdword [fd.out]\n" -"\tsys.close\n" -msgstr "" -"\tpush\tdword [fd.out]\n" -"\tsys.close\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1340 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2573 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3829 -#, no-wrap -msgid "" -"\t; return success\n" -"\tpush\tdword 0\n" -"\tsys.exit\n" -msgstr "" -"\t; return success\n" -"\tpush\tdword 0\n" -"\tsys.exit\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1360 -#, no-wrap -msgid "" -"align 4\n" -"write:\n" -"\tsub\tedi, ecx\t; start of buffer\n" -"\tpush\tecx\n" -"\tpush\tedi\n" -"\tpush\tdword [fd.out]\n" -"\tsys.write\n" -"\tadd\tesp, byte 12\n" -"\tsub\teax, eax\n" -"\tsub\tecx, ecx\t; buffer is empty now\n" -"\tret\n" -msgstr "" -"align 4\n" -"write:\n" -"\tsub\tedi, ecx\t; start of buffer\n" -"\tpush\tecx\n" -"\tpush\tedi\n" -"\tpush\tdword [fd.out]\n" -"\tsys.write\n" -"\tadd\tesp, byte 12\n" -"\tsub\teax, eax\n" -"\tsub\tecx, ecx\t; buffer is empty now\n" -"\tret\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1364 -msgid "" -"In our `.data` section we now have two new variables, `fd.in` and `fd.out`. " -"We store the input and output file descriptors here." -msgstr "" -"В нашем разделе `.data` теперь есть две новые переменные, `fd.in` и `fd." -"out`. Здесь мы сохраняем дескрипторы файлов для ввода и вывода." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1366 -msgid "" -"In the `.text` section we have replaced the references to `stdin` and " -"`stdout` with `[fd.in]` and `[fd.out]`." -msgstr "" -"В разделе `.text` мы заменили ссылки с `stdin` и `stdout` на `[fd.in]` и " -"`[fd.out]`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1369 -msgid "" -"The `.text` section now starts with a simple error handler, which does " -"nothing but exit the program with a return value of `1`. The error handler " -"is before `_start` so we are within a short distance from where the errors " -"occur." -msgstr "" -"Раздел `.text` теперь начинается с простого обработчика ошибок, который " -"просто завершает программу с кодом возврата `1`. Обработчик ошибок " -"расположен перед `_start`, чтобы находиться вблизи от места возникновения " -"ошибок." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1372 -msgid "" -"Naturally, the program execution still begins at `_start`. First, we remove " -"`argc` and `argv[0]` from the stack: They are of no interest to us (in this " -"program, that is)." -msgstr "" -"Естественно, выполнение программы по-прежнему начинается с `_start`. Сначала " -"мы удаляем `argc` и `argv[0]` из стека: они не представляют для нас интереса " -"(по крайней мере, в этой программе)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1378 -msgid "" -"We pop `argv[1]` to `ECX`. This register is particularly suited for " -"pointers, as we can handle NULL pointers with `jecxz`. If `argv[1]` is not " -"NULL, we try to open the file named in the first argument. Otherwise, we " -"continue the program as before: Reading from `stdin`, writing to `stdout`. " -"If we fail to open the input file (e.g., it does not exist), we jump to the " -"error handler and quit." -msgstr "" -"Мы помещаем `argv[1]` в `ECX`. Этот регистр особенно подходит для " -"указателей, так как мы можем обрабатывать NULL-указатели с помощью `jecxz`. " -"Если `argv[1]` не равен NULL, мы пытаемся открыть файл с именем, указанным в " -"первом аргументе. В противном случае продолжаем программу как раньше: чтение " -"из `stdin`, запись в `stdout`. Если нам не удаётся открыть входной файл " -"(например, он не существует), мы переходим к обработчику ошибок и завершаем " -"работу." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1383 -msgid "" -"If all went well, we now check for the second argument. If it is there, we " -"open the output file. Otherwise, we send the output to `stdout`. If we " -"fail to open the output file (e.g., it exists and we do not have the write " -"permission), we, again, jump to the error handler." -msgstr "" -"Если всё прошло успешно, мы проверяем второй аргумент. Если он присутствует, " -"мы открываем выходной файл. В противном случае, мы отправляем вывод в " -"`stdout`. Если нам не удаётся открыть выходной файл (например, он существует " -"и у нас нет прав на запись), мы снова переходим к обработчику ошибок." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1385 -msgid "" -"The rest of the code is the same as before, except we close the input and " -"output files before exiting, and, as mentioned, we use `[fd.in]` and `[fd." -"out]`." -msgstr "" -"Остальная часть кода остаётся прежней, за исключением того, что мы закрываем " -"входной и выходной файлы перед завершением, и, как упоминалось, используем " -"`[fd.in]` и `[fd.out]`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1387 -msgid "Our executable is now a whopping 768 bytes long." -msgstr "Наш исполняемый файл теперь имеет внушительный размер в 768 байт." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1390 -msgid "" -"Can we still improve it? Of course! Every program can be improved. Here are " -"a few ideas of what we could do:" -msgstr "" -"Можем ли мы улучшить его ещё? Конечно! Каждую программу можно улучшить. Вот " -"несколько идей, что мы могли бы сделать:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1392 -msgid "Have our error handler print a message to `stderr`." -msgstr "Сделать наш обработчик ошибок, выводящий сообщение в `stderr`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1393 -msgid "Add error handlers to the `read` and `write` functions." -msgstr "Добавить обработчики ошибок в функции `read` и `write`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1394 -msgid "" -"Close `stdin` when we open an input file, `stdout` when we open an output " -"file." -msgstr "" -"Закрывать `stdin` при открытии входного файла, `stdout` при открытии " -"выходного файла." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1395 -msgid "" -"Add command line switches, such as `-i` and `-o`, so we can list the input " -"and output files in any order, or perhaps read from `stdin` and write to a " -"file." -msgstr "" -"Добавить параметры командной строки, такие как `-i` и `-o`, чтобы можно было " -"перечислять входные и выходные файлы в любом порядке или, возможно, читать " -"из `stdin` и записывать в файл." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1396 -msgid "Print a usage message if command line arguments are incorrect." -msgstr "" -"Выводить сообщение с подсказкой об использовании программы, если аргументы " -"командной строки указаны неверно." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1398 -msgid "" -"I shall leave these enhancements as an exercise to the reader: You already " -"know everything you need to know to implement them." -msgstr "" -"Я оставлю эти улучшения в качестве упражнения для читателя: вы уже знаете " -"всё необходимое для их реализации." - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1400 -#, no-wrap -msgid "UNIX(R) Environment" -msgstr "Окружение UNIX(R)" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1404 -msgid "" -"An important UNIX(R) concept is the environment, which is defined by " -"_environment variables_. Some are set by the system, others by you, yet " -"others by the shell, or any program that loads another program." -msgstr "" -"Важным концептом UNIX(R) является окружение, которое определяется " -"_переменными окружения_. Некоторые из них устанавливаются системой, другие — " -"пользователем, третьи — оболочкой или любой программой, которая загружает " -"другую программу." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1406 -#, no-wrap -msgid "How to Find Environment Variables" -msgstr "Как найти переменные окружения" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1411 -msgid "" -"I said earlier that when a program starts executing, the stack contains " -"`argc` followed by the NULL-terminated `argv` array, followed by something " -"else. The \"something else\" is the _environment_, or, to be more precise, " -"a NULL-terminated array of pointers to _environment variables_. This is " -"often referred to as `env`." -msgstr "" -"Я говорил ранее, что когда программа начинает выполняться, в стеке находятся " -"`argc`, за которым следует массив `argv`, завершающийся NULL, а затем что-то " -"ещё. Это \"что-то ещё\" — это _окружение_, или, если быть точнее, массив " -"указателей на _переменные окружения_, завершающийся NULL. Это часто называют " -"`env`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1414 -msgid "" -"The structure of `env` is the same as that of `argv`, a list of memory " -"addresses followed by a NULL (`0`). In this case, there is no `\"envc\"`-we " -"figure out where the array ends by searching for the final NULL." -msgstr "" -"Структура `env` такая же, как у `argv` — список адресов памяти, " -"заканчивающийся NULL (`0`). В данном случае нет `\"envc\"` — конец массива " -"определяется поиском последнего NULL." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1417 -msgid "" -"The variables usually come in the `name=value` format, but sometimes the " -"`=value` part may be missing. We need to account for that possibility." -msgstr "" -"Переменные обычно имеют формат `name=value`, но иногда часть `=value` может " -"отсутствовать. Необходимо учитывать эту вероятность." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1419 -#, no-wrap -msgid "webvars" -msgstr "webvars" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1423 -msgid "" -"I could just show you some code that prints the environment the same way the " -"UNIX(R) env command does. But I thought it would be more interesting to " -"write a simple assembly language CGI utility." -msgstr "" -"Я мог бы просто показать вам код, который выводит окружение так же, как " -"команда UNIX(R) env. Но я подумал, что будет интереснее написать простую CGI-" -"утилиту на ассемблере." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1425 -#, no-wrap -msgid "CGI: a Quick Overview" -msgstr "CGI: краткий обзор" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1428 -msgid "" -"I have a http://www.whizkidtech.redprince.net/cgi-bin/tutorial[detailed CGI " -"tutorial] on my web site, but here is a very quick overview of CGI:" -msgstr "" -"У меня есть http://www.whizkidtech.redprince.net/cgi-bin/tutorial[подробное " -"руководство по CGI] на моем веб-сайте, но вот очень краткий обзор CGI:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1430 -msgid "" -"The web server communicates with the CGI program by setting _environment " -"variables_." -msgstr "" -"Веб-сервер взаимодействует с CGI-программой, устанавливая _переменные " -"окружения_." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1431 -msgid "" -"The CGI program sends its output to [.filename]#stdout#. The web server " -"reads it from there." -msgstr "" -"Программа CGI отправляет свой вывод в [.filename]#stdout#. Веб-сервер " -"считывает его оттуда." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1432 -msgid "It must start with an HTTP header followed by two blank lines." -msgstr "" -"Он должен начинаться с HTTP-заголовка, за которым следуют две пустые строки." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1433 -msgid "" -"It then prints the HTML code, or whatever other type of data it is producing." -msgstr "" -"Затем он выводит HTML-код или любые другие данные, которые он генерирует." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1438 -msgid "" -"While certain _environment variables_ use standard names, others vary, " -"depending on the web server. That makes webvars quite a useful diagnostic " -"tool." -msgstr "" -"В то время как некоторые _переменные окружения_ используют стандартные " -"имена, другие различаются в зависимости от веб-сервера. Это делает программу " -"webvars весьма полезным инструментом для диагностики." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1441 -#, no-wrap -msgid "The Code" -msgstr "Код" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1445 -msgid "" -"Our webvars program, then, must send out the HTTP header followed by some " -"HTML mark-up. It then must read the _environment variables_ one by one and " -"send them out as part of the HTML page." -msgstr "" -"Наша программа webvars, таким образом, должна отправить HTTP-заголовок, за " -"которым следует HTML-разметка. Затем она должна прочитать _переменные " -"окружения_ одну за другой и отправить их как часть HTML-страницы." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1448 -msgid "" -"The code follows. I placed comments and explanations right inside the code:" -msgstr "Код приведен ниже. Я разместил комментарии и пояснения прямо в коде:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1485 -#, no-wrap -msgid "" -";;;;;;; webvars.asm ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -";\n" -"; Copyright (c) 2000 G. Adam Stanislav\n" -"; All rights reserved.\n" -";\n" -"; Redistribution and use in source and binary forms, with or without\n" -"; modification, are permitted provided that the following conditions\n" -"; are met:\n" -"; 1. Redistributions of source code must retain the above copyright\n" -"; notice, this list of conditions and the following disclaimer.\n" -"; 2. Redistributions in binary form must reproduce the above copyright\n" -"; notice, this list of conditions and the following disclaimer in the\n" -"; documentation and/or other materials provided with the distribution.\n" -";\n" -"; THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\n" -"; ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n" -"; IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\n" -"; ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE\n" -"; FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n" -"; DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\n" -"; OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\n" -"; HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\n" -"; LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\n" -"; OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\n" -"; SUCH DAMAGE.\n" -";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -";\n" -"; Version 1.0\n" -";\n" -"; Started:\t 8-Dec-2000\n" -"; Updated:\t 8-Dec-2000\n" -";\n" -";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -"%include\t'system.inc'\n" -msgstr "" -";;;;;;; webvars.asm ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -";\n" -"; Copyright (c) 2000 G. Adam Stanislav\n" -"; All rights reserved.\n" -";\n" -"; Redistribution and use in source and binary forms, with or without\n" -"; modification, are permitted provided that the following conditions\n" -"; are met:\n" -"; 1. Redistributions of source code must retain the above copyright\n" -"; notice, this list of conditions and the following disclaimer.\n" -"; 2. Redistributions in binary form must reproduce the above copyright\n" -"; notice, this list of conditions and the following disclaimer in the\n" -"; documentation and/or other materials provided with the distribution.\n" -";\n" -"; THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND\n" -"; ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE\n" -"; IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE\n" -"; ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE\n" -"; FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\n" -"; DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS\n" -"; OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\n" -"; HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT\n" -"; LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY\n" -"; OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF\n" -"; SUCH DAMAGE.\n" -";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -";\n" -"; Version 1.0\n" -";\n" -"; Started:\t 8-Dec-2000\n" -"; Updated:\t 8-Dec-2000\n" -";\n" -";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -"%include\t'system.inc'\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1522 -#, no-wrap -msgid "" -"section\t.data\n" -"http\tdb\t'Content-type: text/html', 0Ah, 0Ah\n" -"\tdb\t'<?xml version=\"1.0\" encoding=\"utf-8\"?>', 0Ah\n" -"\tdb\t'<!DOCTYPE html PUBLIC \"-//W3C/DTD XHTML Strict//EN\" '\n" -"\tdb\t'\"DTD/xhtml1-strict.dtd\">', 0Ah\n" -"\tdb\t'<html xmlns=\"http://www.w3.org/1999/xhtml\" '\n" -"\tdb\t'xml.lang=\"en\" lang=\"en\">', 0Ah\n" -"\tdb\t'<head>', 0Ah\n" -"\tdb\t'<title>Web Environment</title>', 0Ah\n" -"\tdb\t'<meta name=\"author\" content=\"G. Adam Stanislav\" />', 0Ah\n" -"\tdb\t'</head>', 0Ah, 0Ah\n" -"\tdb\t'<body bgcolor=\"#ffffff\" text=\"#000000\" link=\"#0000ff\" '\n" -"\tdb\t'vlink=\"#840084\" alink=\"#0000ff\">', 0Ah\n" -"\tdb\t'<div class=\"webvars\">', 0Ah\n" -"\tdb\t'<h1>Web Environment</h1>', 0Ah\n" -"\tdb\t'<p>The following <b>environment variables</b> are defined '\n" -"\tdb\t'on this web server:</p>', 0Ah, 0Ah\n" -"\tdb\t'<table align=\"center\" width=\"80\" border=\"0\" cellpadding=\"10\" '\n" -"\tdb\t'cellspacing=\"0\" class=\"webvars\">', 0Ah\n" -"httplen\tequ\t$-http\n" -"left\tdb\t'<tr>', 0Ah\n" -"\tdb\t'<td class=\"name\"><tt>'\n" -"leftlen\tequ\t$-left\n" -"middle\tdb\t'</tt></td>', 0Ah\n" -"\tdb\t'<td class=\"value\"><tt><b>'\n" -"midlen\tequ\t$-middle\n" -"undef\tdb\t'<i>(undefined)</i>'\n" -"undeflen\tequ\t$-undef\n" -"right\tdb\t'</b></tt></td>', 0Ah\n" -"\tdb\t'</tr>', 0Ah\n" -"rightlen\tequ\t$-right\n" -"wrap\tdb\t'</table>', 0Ah\n" -"\tdb\t'</div>', 0Ah\n" -"\tdb\t'</body>', 0Ah\n" -"\tdb\t'</html>', 0Ah, 0Ah\n" -"wraplen\tequ\t$-wrap\n" -msgstr "" -"section\t.data\n" -"http\tdb\t'Content-type: text/html', 0Ah, 0Ah\n" -"\tdb\t'<?xml version=\"1.0\" encoding=\"utf-8\"?>', 0Ah\n" -"\tdb\t'<!DOCTYPE html PUBLIC \"-//W3C/DTD XHTML Strict//EN\" '\n" -"\tdb\t'\"DTD/xhtml1-strict.dtd\">', 0Ah\n" -"\tdb\t'<html xmlns=\"http://www.w3.org/1999/xhtml\" '\n" -"\tdb\t'xml.lang=\"en\" lang=\"en\">', 0Ah\n" -"\tdb\t'<head>', 0Ah\n" -"\tdb\t'<title>Web Environment</title>', 0Ah\n" -"\tdb\t'<meta name=\"author\" content=\"G. Adam Stanislav\" />', 0Ah\n" -"\tdb\t'</head>', 0Ah, 0Ah\n" -"\tdb\t'<body bgcolor=\"#ffffff\" text=\"#000000\" link=\"#0000ff\" '\n" -"\tdb\t'vlink=\"#840084\" alink=\"#0000ff\">', 0Ah\n" -"\tdb\t'<div class=\"webvars\">', 0Ah\n" -"\tdb\t'<h1>Web Environment</h1>', 0Ah\n" -"\tdb\t'<p>The following <b>environment variables</b> are defined '\n" -"\tdb\t'on this web server:</p>', 0Ah, 0Ah\n" -"\tdb\t'<table align=\"center\" width=\"80\" border=\"0\" cellpadding=\"10\" '\n" -"\tdb\t'cellspacing=\"0\" class=\"webvars\">', 0Ah\n" -"httplen\tequ\t$-http\n" -"left\tdb\t'<tr>', 0Ah\n" -"\tdb\t'<td class=\"name\"><tt>'\n" -"leftlen\tequ\t$-left\n" -"middle\tdb\t'</tt></td>', 0Ah\n" -"\tdb\t'<td class=\"value\"><tt><b>'\n" -"midlen\tequ\t$-middle\n" -"undef\tdb\t'<i>(undefined)</i>'\n" -"undeflen\tequ\t$-undef\n" -"right\tdb\t'</b></tt></td>', 0Ah\n" -"\tdb\t'</tr>', 0Ah\n" -"rightlen\tequ\t$-right\n" -"wrap\tdb\t'</table>', 0Ah\n" -"\tdb\t'</div>', 0Ah\n" -"\tdb\t'</body>', 0Ah\n" -"\tdb\t'</html>', 0Ah, 0Ah\n" -"wraplen\tequ\t$-wrap\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1532 -#, no-wrap -msgid "" -"section\t.text\n" -"global\t_start\n" -"_start:\n" -"\t; First, send out all the http and xhtml stuff that is\n" -"\t; needed before we start showing the environment\n" -"\tpush\tdword httplen\n" -"\tpush\tdword http\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -msgstr "" -"section\t.text\n" -"global\t_start\n" -"_start:\n" -"\t; First, send out all the http and xhtml stuff that is\n" -"\t; needed before we start showing the environment\n" -"\tpush\tdword httplen\n" -"\tpush\tdword http\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1536 -#, no-wrap -msgid "" -"\t; Now find how far on the stack the environment pointers\n" -"\t; are. We have 12 bytes we have pushed before \"argc\"\n" -"\tmov\teax, [esp+12]\n" -msgstr "" -"\t; Now find how far on the stack the environment pointers\n" -"\t; are. We have 12 bytes we have pushed before \"argc\"\n" -"\tmov\teax, [esp+12]\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1551 -#, no-wrap -msgid "" -"\t; We need to remove the following from the stack:\n" -"\t;\n" -"\t;\tThe 12 bytes we pushed for sys.write\n" -"\t;\tThe 4 bytes of argc\n" -"\t;\tThe EAX*4 bytes of argv\n" -"\t;\tThe 4 bytes of the NULL after argv\n" -"\t;\n" -"\t; Total:\n" -"\t;\t20 + eax * 4\n" -"\t;\n" -"\t; Because stack grows down, we need to ADD that many bytes\n" -"\t; to ESP.\n" -"\tlea\tesp, [esp+20+eax*4]\n" -"\tcld\t\t; This should already be the case, but let's be sure.\n" -msgstr "" -"\t; We need to remove the following from the stack:\n" -"\t;\n" -"\t;\tThe 12 bytes we pushed for sys.write\n" -"\t;\tThe 4 bytes of argc\n" -"\t;\tThe EAX*4 bytes of argv\n" -"\t;\tThe 4 bytes of the NULL after argv\n" -"\t;\n" -"\t; Total:\n" -"\t;\t20 + eax * 4\n" -"\t;\n" -"\t; Because stack grows down, we need to ADD that many bytes\n" -"\t; to ESP.\n" -"\tlea\tesp, [esp+20+eax*4]\n" -"\tcld\t\t; This should already be the case, but let's be sure.\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1557 -#, no-wrap -msgid "" -"\t; Loop through the environment, printing it out\n" -".loop:\n" -"\tpop\tedi\n" -"\tor\tedi, edi\t; Done yet?\n" -"\tje\tnear .wrap\n" -msgstr "" -"\t; Loop through the environment, printing it out\n" -".loop:\n" -"\tpop\tedi\n" -"\tor\tedi, edi\t; Done yet?\n" -"\tje\tnear .wrap\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1563 -#, no-wrap -msgid "" -"\t; Print the left part of HTML\n" -"\tpush\tdword leftlen\n" -"\tpush\tdword left\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -msgstr "" -"\t; Print the left part of HTML\n" -"\tpush\tdword leftlen\n" -"\tpush\tdword left\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1574 -#, no-wrap -msgid "" -"\t; It may be tempting to search for the '=' in the env string next.\n" -"\t; But it is possible there is no '=', so we search for the\n" -"\t; terminating NUL first.\n" -"\tmov\tesi, edi\t; Save start of string\n" -"\tsub\tecx, ecx\n" -"\tnot\tecx\t\t; ECX = FFFFFFFF\n" -"\tsub\teax, eax\n" -"repne\tscasb\n" -"\tnot\tecx\t\t; ECX = string length + 1\n" -"\tmov\tebx, ecx\t; Save it in EBX\n" -msgstr "" -"\t; It may be tempting to search for the '=' in the env string next.\n" -"\t; But it is possible there is no '=', so we search for the\n" -"\t; terminating NUL first.\n" -"\tmov\tesi, edi\t; Save start of string\n" -"\tsub\tecx, ecx\n" -"\tnot\tecx\t\t; ECX = FFFFFFFF\n" -"\tsub\teax, eax\n" -"repne\tscasb\n" -"\tnot\tecx\t\t; ECX = string length + 1\n" -"\tmov\tebx, ecx\t; Save it in EBX\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1581 -#, no-wrap -msgid "" -"\t; Now is the time to find '='\n" -"\tmov\tedi, esi\t; Start of string\n" -"\tmov\tal, '='\n" -"repne\tscasb\n" -"\tnot\tecx\n" -"\tadd\tecx, ebx\t; Length of name\n" -msgstr "" -"\t; Now is the time to find '='\n" -"\tmov\tedi, esi\t; Start of string\n" -"\tmov\tal, '='\n" -"repne\tscasb\n" -"\tnot\tecx\n" -"\tadd\tecx, ebx\t; Length of name\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1586 -#, no-wrap -msgid "" -"\tpush\tecx\n" -"\tpush\tesi\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -msgstr "" -"\tpush\tecx\n" -"\tpush\tesi\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1592 -#, no-wrap -msgid "" -"\t; Print the middle part of HTML table code\n" -"\tpush\tdword midlen\n" -"\tpush\tdword middle\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -msgstr "" -"\t; Print the middle part of HTML table code\n" -"\tpush\tdword midlen\n" -"\tpush\tdword middle\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1596 -#, no-wrap -msgid "" -"\t; Find the length of the value\n" -"\tnot\tecx\n" -"\tlea\tebx, [ebx+ecx-1]\n" -msgstr "" -"\t; Find the length of the value\n" -"\tnot\tecx\n" -"\tlea\tebx, [ebx+ecx-1]\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1600 -#, no-wrap -msgid "" -"\t; Print \"undefined\" if 0\n" -"\tor\tebx, ebx\n" -"\tjne\t.value\n" -msgstr "" -"\t; Print \"undefined\" if 0\n" -"\tor\tebx, ebx\n" -"\tjne\t.value\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1603 -#, no-wrap -msgid "" -"\tmov\tebx, undeflen\n" -"\tmov\tedi, undef\n" -msgstr "" -"\tmov\tebx, undeflen\n" -"\tmov\tedi, undef\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1609 -#, no-wrap -msgid "" -".value:\n" -"\tpush\tebx\n" -"\tpush\tedi\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -msgstr "" -".value:\n" -"\tpush\tebx\n" -"\tpush\tedi\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1615 -#, no-wrap -msgid "" -"\t; Print the right part of the table row\n" -"\tpush\tdword rightlen\n" -"\tpush\tdword right\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -msgstr "" -"\t; Print the right part of the table row\n" -"\tpush\tdword rightlen\n" -"\tpush\tdword right\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1618 -#, no-wrap -msgid "" -"\t; Get rid of the 60 bytes we have pushed\n" -"\tadd\tesp, byte 60\n" -msgstr "" -"\t; Get rid of the 60 bytes we have pushed\n" -"\tadd\tesp, byte 60\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1621 -#, no-wrap -msgid "" -"\t; Get the next variable\n" -"\tjmp\t.loop\n" -msgstr "" -"\t; Get the next variable\n" -"\tjmp\t.loop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1628 -#, no-wrap -msgid "" -".wrap:\n" -"\t; Print the rest of HTML\n" -"\tpush\tdword wraplen\n" -"\tpush\tdword wrap\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" -msgstr "" -".wrap:\n" -"\t; Print the rest of HTML\n" -"\tpush\tdword wraplen\n" -"\tpush\tdword wrap\n" -"\tpush\tdword stdout\n" -"\tsys.write\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1632 -#, no-wrap -msgid "" -"\t; Return success\n" -"\tpush\tdword 0\n" -"\tsys.exit\n" -msgstr "" -"\t; Return success\n" -"\tpush\tdword 0\n" -"\tsys.exit\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1636 -msgid "" -"This code produces a 1,396-byte executable. Most of it is data, i.e., the " -"HTML mark-up we need to send out." -msgstr "" -"Этот код создаёт исполняемый файл размером 1 396 байт. Большая его часть — " -"это данные, а именно HTML-разметка, которую нам нужно отправить." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1638 -msgid "Assemble and link it as usual:" -msgstr "Запустите ассемблер и слинкуйте как обычно:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1643 -#, no-wrap -msgid "" -"% nasm -f elf webvars.asm\n" -"% ld -s -o webvars webvars.o\n" -msgstr "" -"% nasm -f elf webvars.asm\n" -"% ld -s -o webvars webvars.o\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1647 -msgid "" -"To use it, you need to upload [.filename]#webvars# to your web server. " -"Depending on how your web server is set up, you may have to store it in a " -"special [.filename]#cgi-bin# directory, or perhaps rename it with a [." -"filename]#.cgi# extension." -msgstr "" -"Для использования необходимо загрузить [.filename]#webvars# на ваш веб-" -"сервер. В зависимости от настроек веб-сервера, возможно, потребуется " -"разместить его в специальном каталоге [.filename]#cgi-bin# или переименовать " -"с расширением [.filename]#.cgi#." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1651 -msgid "" -"Then you need to use your browser to view its output. To see its output on " -"my web server, please go to http://www.int80h.org/webvars/[http://www.int80h." -"org/webvars/]. If curious about the additional environment variables " -"present in a password protected web directory, go to http://www.int80h.org/" -"private/[http://www.int80h.org/private/], using the name `asm` and password " -"`programmer`." -msgstr "" -"Затем вам нужно использовать браузер для просмотра вывода. Чтобы увидеть " -"вывод на моем веб-сервере, перейдите по ссылке http://www.int80h.org/webvars/" -"[http://www.int80h.org/webvars/]. Если вам интересно узнать о дополнительных " -"переменных окружения в защищенном паролем веб-каталоге, перейдите по адресу " -"http://www.int80h.org/private/[http://www.int80h.org/private/], используя " -"имя `asm` и пароль `programmer`." - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1653 -#, no-wrap -msgid "Working with Files" -msgstr "Работа с файлами" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1658 -msgid "" -"We have already done some basic file work: We know how to open and close " -"them, how to read and write them using buffers. But UNIX(R) offers much " -"more functionality when it comes to files. We will examine some of it in " -"this section, and end up with a nice file conversion utility." -msgstr "" -"Мы уже выполнили некоторые базовые операции с файлами: мы знаем, как их " -"открывать и закрывать, как читать и записывать их с использованием буферов. " -"Однако UNIX(R) предлагает гораздо больше возможностей при работе с файлами. " -"В этом разделе мы рассмотрим некоторые из них и в итоге создадим удобную " -"утилиту для преобразования файлов." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1661 -msgid "" -"Indeed, let us start at the end, that is, with the file conversion utility. " -"It always makes programming easier when we know from the start what the end " -"product is supposed to do." -msgstr "" -"В самом деле, начнем с конца, то есть с утилиты преобразования файлов. " -"Всегда легче программировать, когда с самого начала известно, каким должен " -"быть конечный продукт." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1667 -msgid "" -"One of the first programs I wrote for UNIX(R) was link:ftp://ftp.int80h.org/" -"unix/tuc/[tuc], a text-to-UNIX(R) file converter. It converts a text file " -"from other operating systems to a UNIX(R) text file. In other words, it " -"changes from different kind of line endings to the newline convention of " -"UNIX(R). It saves the output in a different file. Optionally, it converts " -"a UNIX(R) text file to a DOS text file." -msgstr "" -"Одной из первых программ, которые я написал для UNIX(R), была link:ftp://ftp." -"int80h.org/unix/tuc/[tuc] — конвертер текста в файл UNIX(R). Она преобразует " -"текстовый файл из других операционных систем в текстовый файл UNIX(R). " -"Другими словами, она изменяет различные виды окончаний строк на стандартные " -"для UNIX(R). Результат сохраняется в другом файле. По желанию, она может " -"преобразовать текстовый файл UNIX(R) в текстовый файл DOS." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1671 -msgid "" -"I have used tuc extensively, but always only to convert from some other OS " -"to UNIX(R), never the other way. I have always wished it would just " -"overwrite the file instead of me having to send the output to a different " -"file. Most of the time, I end up using it like this:" -msgstr "" -"Я широко использовал `tuc`, но всегда только для преобразования из какой-" -"либо другой ОС в UNIX(R), никогда наоборот. Мне всегда хотелось, чтобы он " -"просто перезаписывал файл, вместо того чтобы мне приходилось отправлять " -"вывод в другой файл. В большинстве случаев я в итоге использую его так:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1676 -#, no-wrap -msgid "" -"% tuc myfile tempfile\n" -"% mv tempfile myfile\n" -msgstr "" -"% tuc myfile tempfile\n" -"% mv tempfile myfile\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1679 -msgid "" -"It would be nice to have a ftuc, i.e., _fast tuc_, and use it like this:" -msgstr "" -"Было бы здорово иметь ftuc, т.е., _быстрый tuc_, и использовать его вот так:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1683 -#, no-wrap -msgid "% ftuc myfile\n" -msgstr "% ftuc myfile\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1686 -msgid "" -"In this chapter, then, we will write ftuc in assembly language (the original " -"tuc is in C), and study various file-oriented kernel services in the process." -msgstr "" -"В этой главе мы напишем ftuc на языке ассемблера (оригинальный tuc написан " -"на C) и в процессе изучим различные файловые сервисы ядра." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1688 -msgid "" -"At first sight, such a file conversion is very simple: All you have to do is " -"strip the carriage returns, right?" -msgstr "" -"На первый взгляд, такое преобразование файла кажется очень простым: нужно " -"всего лишь удалить символы возврата каретки, верно?" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1690 -msgid "" -"If you answered yes, think again: That approach will work most of the time " -"(at least with MS DOS text files), but will fail occasionally." -msgstr "" -"Если вы ответили «да», подумайте ещё раз: такой подход будет работать в " -"большинстве случаев (по крайней мере, с текстовыми файлами MS DOS), но " -"иногда он будет давать сбой." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1695 -msgid "" -"The problem is that not all non UNIX(R) text files end their line with the " -"carriage return / line feed sequence. Some use carriage returns without " -"line feeds. Others combine several blank lines into a single carriage " -"return followed by several line feeds. And so on." -msgstr "" -"Проблема в том, что не все текстовые файлы, не относящиеся к UNIX(R), " -"завершают строки последовательностью возврата каретки / перевода строки. " -"Некоторые используют возврат каретки без перевода строки. Другие объединяют " -"несколько пустых строк в один возврат каретки, за которым следует несколько " -"переводов строки. И так далее." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1697 -msgid "" -"A text file converter, then, must be able to handle any possible line " -"endings:" -msgstr "" -"Конвертер текстовых файлов, следовательно, должен уметь обрабатывать любые " -"возможные окончания строк:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1699 -msgid "carriage return / line feed" -msgstr "возврат каретки (carriage return) / перевод строки (line feed)" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1700 -msgid "carriage return" -msgstr "возврат каретки" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1701 -msgid "line feed / carriage return" -msgstr "перевод строки / возврат каретки" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1702 -msgid "line feed" -msgstr "перевод строки" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1704 -msgid "" -"It should also handle files that use some kind of a combination of the above " -"(e.g., carriage return followed by several line feeds)." -msgstr "" -"Это также должно обрабатывать файлы, использующие комбинации вышеуказанного " -"(например, возврат каретки с последующими несколькими переводами строки)." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1706 -#, no-wrap -msgid "Finite State Machine" -msgstr "Конечный автомат" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1713 -msgid "" -"The problem is easily solved by the use of a technique called _finite state " -"machine_, originally developed by the designers of digital electronic " -"circuits. A _finite state machine_ is a digital circuit whose output is " -"dependent not only on its input but on its previous input, i.e., on its " -"state. The microprocessor is an example of a _finite state machine_: Our " -"assembly language code is assembled to machine language in which some " -"assembly language code produces a single byte of machine language, while " -"others produce several bytes. As the microprocessor fetches the bytes from " -"the memory one by one, some of them simply change its state rather than " -"produce some output. When all the bytes of the op code are fetched, the " -"microprocessor produces some output, or changes the value of a register, etc." -msgstr "" -"Проблема легко решается с использованием техники, называемой _конечный " -"автомат_, изначально разработанной создателями цифровых электронных схем. " -"_Конечный автомат_ — это цифровая схема, выход которой зависит не только от " -"входа, но и от предыдущего входа, то есть от её состояния. Микропроцессор " -"является примером _конечного автомата_: наш код на языке ассемблера " -"транслируется в машинный язык, где одни инструкции ассемблера превращаются в " -"один байт машинного кода, а другие — в несколько байтов. Когда " -"микропроцессор извлекает байты из памяти один за другим, некоторые из них " -"просто изменяют его состояние, а не производят какой-либо выходной сигнал. " -"После извлечения всех байтов кода операции микропроцессор выдаёт выходной " -"сигнал, изменяет значение регистра и т. д." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1716 -msgid "" -"Because of that, all software is essentially a sequence of state " -"instructions for the microprocessor. Nevertheless, the concept of _finite " -"state machine_ is useful in software design as well." -msgstr "" -"Из-за этого всё программное обеспечение по сути представляет собой " -"последовательность инструкций состояния для микропроцессора. Тем не менее, " -"концепция _конечного автомата_ также полезна при проектировании программного " -"обеспечения." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1719 -msgid "" -"Our text file converter can be designer as a _finite state machine_ with " -"three possible states. We could call them states 0-2, but it will make our " -"life easier if we give them symbolic names:" -msgstr "" -"Наш конвертер текстовых файлов можно представить в виде _конечного автомата_ " -"с тремя возможными состояниями. Мы могли бы назвать их состояниями 0-2, но " -"будет проще, если дадим им символические имена:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1721 -msgid "ordinary" -msgstr "ordinary" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1722 -msgid "cr" -msgstr "cr" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1723 -msgid "lf" -msgstr "lf" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1725 -msgid "" -"Our program will start in the ordinary state. During this state, the program " -"action depends on its input as follows:" -msgstr "" -"Наша программа начнёт работу в обычном состоянии. В этом состоянии действие " -"программы зависит от её входных данных следующим образом:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1728 -msgid "" -"If the input is anything other than a carriage return or line feed, the " -"input is simply passed on to the output. The state remains unchanged." -msgstr "" -"Если ввод представляет собой что-либо, кроме возврата каретки или перевода " -"строки, ввод просто передаётся на вывод. Состояние остаётся неизменным." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1730 -msgid "" -"If the input is a carriage return, the state is changed to cr. The input is " -"then discarded, i.e., no output is made." -msgstr "" -"Если входной символ — возврат каретки, состояние изменяется на cr. Затем " -"входной символ отбрасывается, т.е. вывод не производится." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1732 -msgid "" -"If the input is a line feed, the state is changed to lf. The input is then " -"discarded." -msgstr "" -"Если входной символ является переводом строки, состояние изменяется на lf. " -"Затем входной символ отбрасывается." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1735 -msgid "" -"Whenever we are in the cr state, it is because the last input was a carriage " -"return, which was unprocessed. What our software does in this state again " -"depends on the current input:" -msgstr "" -"Всякий раз, когда мы находимся в состоянии `cr`, это означает, что последним " -"вводом был символ возврата каретки, который не был обработан. Действия " -"нашего программного обеспечения в этом состоянии снова зависят от текущего " -"ввода:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1737 -msgid "" -"If the input is anything other than a carriage return or line feed, output a " -"line feed, then output the input, then change the state to ordinary." -msgstr "" -"Если ввод отличается от возврата каретки или перевода строки, вывести " -"перевод строки, затем вывести ввод, а затем изменить состояние на обычное." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1738 -msgid "" -"If the input is a carriage return, we have received two (or more) carriage " -"returns in a row. We discard the input, we output a line feed, and leave the " -"state unchanged." -msgstr "" -"Если входной символ — возврат каретки, значит, мы получили два (или более) " -"возврата каретки подряд. Мы отбрасываем ввод, выводим перевод строки и " -"оставляем состояние неизменным." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1739 -msgid "" -"If the input is a line feed, we output the line feed and change the state to " -"ordinary. Note that this is not the same as the first case above - if we " -"tried to combine them, we would be outputting two line feeds instead of one." -msgstr "" -"Если входной символ — это перевод строки, мы выводим перевод строки и меняем " -"состояние на обычное. Обратите внимание, что это не то же самое, что в " -"первом случае выше — если бы мы попытались объединить их, мы бы выводили два " -"перевода строки вместо одного." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1743 -msgid "" -"Finally, we are in the lf state after we have received a line feed that was " -"not preceded by a carriage return. This will happen when our file already " -"is in UNIX(R) format, or whenever several lines in a row are expressed by a " -"single carriage return followed by several line feeds, or when line ends " -"with a line feed / carriage return sequence. Here is how we need to handle " -"our input in this state:" -msgstr "" -"Наконец, мы находимся в состоянии `lf` после получения перевода строки, " -"которому не предшествовал возврат каретки. Это произойдет, если наш файл уже " -"в формате UNIX(R), или когда несколько строк подряд выражены одним возвратом " -"каретки, за которым следуют несколько переводов строк, или когда строка " -"заканчивается последовательностью перевода строки / возврата каретки. Вот " -"как нам нужно обрабатывать ввод в этом состоянии:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1745 -msgid "" -"If the input is anything other than a carriage return or line feed, we " -"output a line feed, then output the input, then change the state to " -"ordinary. This is exactly the same action as in the cr state upon receiving " -"the same kind of input." -msgstr "" -"Если ввод отличается от возврата каретки или перевода строки, мы выводим " -"перевод строки, затем выводим ввод и изменяем состояние на обычное. Это " -"действие полностью совпадает с действием в состоянии `cr` при получении " -"аналогичного ввода." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1746 -msgid "" -"If the input is a carriage return, we discard the input, we output a line " -"feed, then change the state to ordinary." -msgstr "" -"Если ввод представляет собой символ возврата каретки, мы отбрасываем ввод, " -"выводим символ перевода строки, затем изменяем состояние на обычное." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1747 -msgid "" -"If the input is a line feed, we output the line feed, and leave the state " -"unchanged." -msgstr "" -"Если входной символ — перевод строки, мы выводим перевод строки и оставляем " -"состояние неизменным." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1749 -#, no-wrap -msgid "The Final State" -msgstr "Конечное состояние" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1754 -msgid "" -"The above _finite state machine_ works for the entire file, but leaves the " -"possibility that the final line end will be ignored. That will happen " -"whenever the file ends with a single carriage return or a single line feed. " -"I did not think of it when I wrote tuc, just to discover that occasionally " -"it strips the last line ending." -msgstr "" -"Приведённый выше _конечный автомат_ работает для всего файла, но оставляет " -"возможность, что последний конец строки будет проигнорирован. Это " -"произойдёт, если файл заканчивается одиночным возвратом каретки или " -"одиночным переводом строки. Я не подумал об этом, когда писал tuc, и лишь " -"позже обнаружил, что иногда он удаляет последний конец строки." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1757 -msgid "" -"This problem is easily fixed by checking the state after the entire file was " -"processed. If the state is not ordinary, we simply need to output one last " -"line feed." -msgstr "" -"Эта проблема легко решается проверкой состояния после обработки всего файла. " -"Если состояние не является обычным, нам просто нужно вывести последний " -"перевод строки." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1763 -msgid "" -"Now that we have expressed our algorithm as a _finite state machine_, we " -"could easily design a dedicated digital electronic circuit (a \"chip\") to " -"do the conversion for us. Of course, doing so would be considerably more " -"expensive than writing an assembly language program." -msgstr "" -"Теперь, когда мы выразили наш алгоритм в виде _конечного автомата_, мы могли " -"бы легко разработать специализированную цифровую электронную схему («чип») " -"для выполнения преобразования. Конечно, это было бы значительно дороже, чем " -"написание программы на языке ассемблера." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1766 -#, no-wrap -msgid "The Output Counter" -msgstr "Счетчик вывода" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1771 -msgid "" -"Because our file conversion program may be combining two characters into " -"one, we need to use an output counter. We initialize it to `0`, and " -"increase it every time we send a character to the output. At the end of the " -"program, the counter will tell us what size we need to set the file to." -msgstr "" -"Поскольку наша программа преобразования файлов может объединять два символа " -"в один, нам необходимо использовать счётчик вывода. Мы инициализируем его " -"значением `0` и увеличиваем каждый раз, когда отправляем символ на выход. В " -"конце программы счётчик укажет, какой размер необходимо установить для файла." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1773 -#, no-wrap -msgid "Implementing FSM in Software" -msgstr "Реализация конечного автомата в программном обеспечении" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1777 -msgid "" -"The hardest part of working with a _finite state machine_ is analyzing the " -"problem and expressing it as a _finite state machine_. That accomplished, " -"the software almost writes itself." -msgstr "" -"Самая сложная часть работы с _конечным автоматом_ — это анализ задачи и её " -"представление в виде _конечного автомата_. После этого программное " -"обеспечение практически пишется само." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1780 -msgid "" -"In a high-level language, such as C, there are several main approaches. One " -"is to use a `switch` statement which chooses what function should be run. " -"For example," -msgstr "" -"На языке высокого уровня, таком как C, существует несколько основных " -"подходов. Один из них — использование оператора `switch`, который выбирает, " -"какую функцию следует выполнить. Например," - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1795 -#, no-wrap -msgid "" -"switch (state) {\n" -"\tdefault:\n" -"\tcase REGULAR:\n" -"\t\tregular(inputchar);\n" -"\t\tbreak;\n" -"\tcase CR:\n" -"\t\tcr(inputchar);\n" -"\t\tbreak;\n" -"\tcase LF:\n" -"\t\tlf(inputchar);\n" -"\t\tbreak;\n" -"\t}\n" -msgstr "" -"switch (state) {\n" -"\tdefault:\n" -"\tcase REGULAR:\n" -"\t\tregular(inputchar);\n" -"\t\tbreak;\n" -"\tcase CR:\n" -"\t\tcr(inputchar);\n" -"\t\tbreak;\n" -"\tcase LF:\n" -"\t\tlf(inputchar);\n" -"\t\tbreak;\n" -"\t}\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1798 -msgid "" -"Another approach is by using an array of function pointers, something like " -"this:" -msgstr "" -"Еще один подход заключается в использовании массива указателей на функции, " -"например:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1802 -#, no-wrap -msgid "(output[state])(inputchar);\n" -msgstr "(output[state])(inputchar);\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1805 -msgid "" -"Yet another is to have `state` be a function pointer, set to point at the " -"appropriate function:" -msgstr "" -"Еще один вариант — сделать `state` указателем на функцию, установив его на " -"соответствующую функцию:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1809 -#, no-wrap -msgid "(*state)(inputchar);\n" -msgstr "(*state)(inputchar);\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1813 -msgid "" -"This is the approach we will use in our program because it is very easy to " -"do in assembly language, and very fast, too. We will simply keep the " -"address of the right procedure in `EBX`, and then just issue:" -msgstr "" -"Это подход, который мы будем использовать в нашей программе, потому что его " -"очень легко реализовать на языке ассемблера, и он также очень быстрый. Мы " -"просто будем хранить адрес нужной процедуры в `EBX`, а затем выполним:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1817 -#, no-wrap -msgid "call\tebx\n" -msgstr "call\tebx\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1821 -msgid "" -"This is possibly faster than hardcoding the address in the code because the " -"microprocessor does not have to fetch the address from the memory-it is " -"already stored in one of its registers. I said _possibly_ because with the " -"caching modern microprocessors do, either way may be equally fast." -msgstr "" -"Это возможно быстрее, чем жёстко задавать адрес в коде, потому что " -"микропроцессору не нужно извлекать адрес из памяти — он уже хранится в одном " -"из его регистров. Я сказал _возможно_, потому что с учётом кэширования, " -"которое выполняют современные микропроцессоры, оба варианта могут быть " -"одинаково быстрыми." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1823 -#, no-wrap -msgid "Memory Mapped Files" -msgstr "Отображенные в память файлы" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1827 -msgid "" -"Because our program works on a single file, we cannot use the approach that " -"worked for us before, i.e., to read from an input file and to write to an " -"output file." -msgstr "" -"Поскольку наша программа работает с одним файлом, мы не можем использовать " -"подход, который работал ранее, то есть чтение из входного файла и запись в " -"выходной файл." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1835 -msgid "" -"UNIX(R) allows us to map a file, or a section of a file, into memory. To do " -"that, we first need to open the file with the appropriate read/write flags. " -"Then we use the `mmap` system call to map it into the memory. One nice " -"thing about `mmap` is that it automatically works with virtual memory: We " -"can map more of the file into the memory than we have physical memory " -"available, yet still access it through regular memory op codes, such as " -"`mov`, `lods`, and `stos`. Whatever changes we make to the memory image of " -"the file will be written to the file by the system. We do not even have to " -"keep the file open: As long as it stays mapped, we can read from it and " -"write to it." -msgstr "" -"UNIX(R) позволяет нам отображать файл или его часть в память. Для этого " -"сначала необходимо открыть файл с соответствующими флагами чтения/записи. " -"Затем мы используем системный вызов `mmap`, чтобы отобразить его в память. " -"Одно из преимуществ `mmap` заключается в том, что он автоматически работает " -"с виртуальной памятью: мы можем отобразить в память больше файла, чем " -"имеется физической памяти, и при этом обращаться к нему с помощью обычных " -"команд работы с памятью, таких как `mov`, `lods` и `stos`. Все изменения, " -"внесённые в память, отображённую из файла, будут записаны в файл системой. " -"Нам даже не нужно держать файл открытым: пока он остаётся отображённым, мы " -"можем читать из него и записывать в него." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1838 -msgid "" -"The 32-bit Intel microprocessors can access up to four gigabytes of memory - " -"physical or virtual. The FreeBSD system allows us to use up to a half of it " -"for file mapping." -msgstr "" -"32-разрядные микропроцессоры Intel могут адресовать до четырёх гигабайт " -"памяти — физической или виртуальной. Система FreeBSD позволяет использовать " -"до половины этого объёма для отображения файлов." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1842 -msgid "" -"For simplicity sake, in this tutorial we will only convert files that can be " -"mapped into the memory in their entirety. There are probably not too many " -"text files that exceed two gigabytes in size. If our program encounters " -"one, it will simply display a message suggesting we use the original tuc " -"instead." -msgstr "" -"Для упрощения в этом руководстве мы будем преобразовывать только файлы, " -"которые могут быть полностью отображены в памяти. Вероятно, не так много " -"текстовых файлов превышают размер в два гигабайта. Если наша программа " -"встретит такой файл, она просто выведет сообщение с предложением " -"использовать оригинальный tuc." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1848 -msgid "" -"If you examine your copy of [.filename]#syscalls.master#, you will find two " -"separate syscalls named `mmap`. This is because of evolution of UNIX(R): " -"There was the traditional BSD `mmap`, syscall 71. That one was superseded " -"by the POSIX(R) `mmap`, syscall 197. The FreeBSD system supports both " -"because older programs were written by using the original BSD version. But " -"new software uses the POSIX(R) version, which is what we will use." -msgstr "" -"Если вы изучите свою копию файла [.filename]#syscalls.master#, вы найдёте " -"два отдельных системных вызова с именем `mmap`. Это связано с эволюцией " -"UNIX(R): существовал традиционный BSD `mmap`, системный вызов 71. Он был " -"заменён на POSIX(R) `mmap`, системный вызов 197. Система FreeBSD " -"поддерживает оба, поскольку старые программы были написаны с использованием " -"оригинальной BSD-версии. Но новое программное обеспечение использует версию " -"POSIX(R), которую мы и будем применять." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1850 -msgid "The [.filename]#syscalls.master# lists the POSIX(R) version like this:" -msgstr "" -"В [.filename]#syscalls.master# POSIX(R) версия указана следующим образом:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1855 -#, no-wrap -msgid "" -"197\tSTD\tBSD\t{ caddr_t mmap(caddr_t addr, size_t len, int prot, \\\n" -"\t\t\t int flags, int fd, long pad, off_t pos); }\n" -msgstr "" -"197\tSTD\tBSD\t{ caddr_t mmap(caddr_t addr, size_t len, int prot, \\\n" -"\t\t\t int flags, int fd, long pad, off_t pos); }\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1859 -msgid "" -"This differs slightly from what man:mmap[2] says. That is because man:" -"mmap[2] describes the C version." -msgstr "" -"Это немного отличается от того, что указано в man:mmap[2]. Это связано с " -"тем, что man:mmap[2] описывает версию на языке C." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1863 -msgid "" -"The difference is in the `long pad` argument, which is not present in the C " -"version. However, the FreeBSD syscalls add a 32-bit pad after ``push``ing a " -"64-bit argument. In this case, `off_t` is a 64-bit value." -msgstr "" -"Разница заключается в аргументе `long pad`, который отсутствует в версии на " -"C. Однако системные вызовы FreeBSD добавляют 32-битный заполнитель после " -"``push`` 64-битного аргумента. В данном случае `off_t` является 64-битным " -"значением." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1865 -msgid "" -"When we are finished working with a memory-mapped file, we unmap it with the " -"`munmap` syscall:" -msgstr "" -"Когда мы завершаем работу с файлом, отображённым в память, мы освобождаем " -"его с помощью системного вызова `munmap`:" - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1869 -msgid "" -"For an in-depth treatment of `mmap`, see W. Richard Stevens' http://www." -"int80h.org/cgi-bin/isbn?isbn=0130810819[Unix Network Programming, Volume 2, " -"Chapter 12]." -msgstr "" -"Для подробного изучения `mmap` см. http://www.int80h.org/cgi-bin/isbn?" -"isbn=0130810819[Unix Network Programming, Volume 2, Chapter 12] У. Ричарда " -"Стивенса." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1872 -#, no-wrap -msgid "Determining File Size" -msgstr "Определение размера файла" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1875 -msgid "" -"Because we need to tell `mmap` how many bytes of the file to map into the " -"memory, and because we want to map the entire file, we need to determine the " -"size of the file." -msgstr "" -"Поскольку нам нужно указать `mmap`, сколько байт файла отобразить в памяти, " -"и поскольку мы хотим отобразить весь файл, нам необходимо определить его " -"размер." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1878 -msgid "" -"We can use the `fstat` syscall to get all the information about an open file " -"that the system can give us. That includes the file size." -msgstr "" -"Мы можем использовать системный вызов `fstat` для получения всей информации " -"об открытом файле, которую система может нам предоставить. Это включает в " -"себя размер файла." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1881 -msgid "" -"Again, [.filename]#syscalls.master# lists two versions of `fstat`, a " -"traditional one (syscall 62), and a POSIX(R) one (syscall 189). Naturally, " -"we will use the POSIX(R) version:" -msgstr "" -"Вновь, в [.filename]#syscalls.master# указаны две версии `fstat`: " -"традиционная (системный вызов 62) и POSIX(R) (системный вызов 189). " -"Естественно, мы будем использовать версию POSIX(R):" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1885 -#, no-wrap -msgid "189\tSTD\tPOSIX\t{ int fstat(int fd, struct stat *sb); }\n" -msgstr "189\tSTD\tPOSIX\t{ int fstat(int fd, struct stat *sb); }\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1889 -msgid "" -"This is a very straightforward call: We pass to it the address of a `stat` " -"structure and the descriptor of an open file. It will fill out the contents " -"of the `stat` structure." -msgstr "" -"Это очень простой вызов: мы передаем ему адрес структуры `stat` и дескриптор " -"открытого файла. Он заполнит содержимое структуры `stat`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1892 -msgid "" -"I do, however, have to say that I tried to declare the `stat` structure in " -"the `.bss` section, and `fstat` did not like it: It set the carry flag " -"indicating an error. After I changed the code to allocate the structure on " -"the stack, everything was working fine." -msgstr "" -"Однако должен сказать, что я пытался объявить структуру `stat` в секции `." -"bss`, и `fstat` это не понравилось: был установлен флаг переноса, " -"указывающий на ошибку. После того как я изменил код, чтобы разместить " -"структуру в стеке, всё заработало как надо." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1894 -#, no-wrap -msgid "Changing the File Size" -msgstr "Изменение размера файла" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1898 -msgid "" -"Because our program may combine carriage return / line feed sequences into " -"straight line feeds, our output may be smaller than our input. However, " -"since we are placing our output into the same file we read the input from, " -"we may have to change the size of the file." -msgstr "" -"Поскольку наша программа может объединять последовательности возврата " -"каретки / перевода строки в простые переводы строк, наш вывод может быть " -"меньше, чем ввод. Однако, так как мы помещаем вывод в тот же файл, из " -"которого читаем ввод, нам может потребоваться изменить размер файла." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1901 -msgid "" -"The `ftruncate` system call allows us to do just that. Despite its somewhat " -"misleading name, the `ftruncate` system call can be used to both truncate " -"the file (make it smaller) and to grow it." -msgstr "" -"Системный вызов `ftruncate` позволяет нам сделать именно это. Несмотря на " -"название , несколько вводящее в заблуждение, системный вызов `ftruncate` " -"может использоваться как для усечения файла (уменьшения его размера), так и " -"для его увеличения." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1904 -msgid "" -"And yes, we will find two versions of `ftruncate` in [.filename]#syscalls." -"master#, an older one (130), and a newer one (201). We will use the newer " -"one:" -msgstr "" -"И да, мы найдем две версии `ftruncate` в [.filename]#syscalls.master#, " -"старую (130) и новую (201). Мы будем использовать новую:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1908 -#, no-wrap -msgid "201\tSTD\tBSD\t{ int ftruncate(int fd, int pad, off_t length); }\n" -msgstr "201\tSTD\tBSD\t{ int ftruncate(int fd, int pad, off_t length); }\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1911 -msgid "Please note that this one contains a `int pad` again." -msgstr "Обратите внимание, что здесь снова присутствует `int pad`." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1913 -#, no-wrap -msgid "ftuc" -msgstr "ftuc" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1918 -msgid "" -"We now know everything we need to write ftuc. We start by adding some new " -"lines in [.filename]#system.inc#. First, we define some constants and " -"structures, somewhere at or near the beginning of the file:" -msgstr "" -"Теперь мы знаем всё, что нужно для написания ftuc. Начнём с добавления " -"нескольких новых строк в [.filename]#system.inc#. Сначала определим " -"некоторые константы и структуры, где-нибудь в начале или около начала файла:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1925 -#, no-wrap -msgid "" -";;;;;;; open flags\n" -"%define\tO_RDONLY\t0\n" -"%define\tO_WRONLY\t1\n" -"%define\tO_RDWR\t2\n" -msgstr "" -";;;;;;; open flags\n" -"%define\tO_RDONLY\t0\n" -"%define\tO_WRONLY\t1\n" -"%define\tO_RDWR\t2\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1934 -#, no-wrap -msgid "" -";;;;;;; mmap flags\n" -"%define\tPROT_NONE\t0\n" -"%define\tPROT_READ\t1\n" -"%define\tPROT_WRITE\t2\n" -"%define\tPROT_EXEC\t4\n" -";;\n" -"%define\tMAP_SHARED\t0001h\n" -"%define\tMAP_PRIVATE\t0002h\n" -msgstr "" -";;;;;;; mmap flags\n" -"%define\tPROT_NONE\t0\n" -"%define\tPROT_READ\t1\n" -"%define\tPROT_WRITE\t2\n" -"%define\tPROT_EXEC\t4\n" -";;\n" -"%define\tMAP_SHARED\t0001h\n" -"%define\tMAP_PRIVATE\t0002h\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1958 -#, no-wrap -msgid "" -";;;;;;; stat structure\n" -"struc\tstat\n" -"st_dev\t\tresd\t1\t; = 0\n" -"st_ino\t\tresd\t1\t; = 4\n" -"st_mode\t\tresw\t1\t; = 8, size is 16 bits\n" -"st_nlink\tresw\t1\t; = 10, ditto\n" -"st_uid\t\tresd\t1\t; = 12\n" -"st_gid\t\tresd\t1\t; = 16\n" -"st_rdev\t\tresd\t1\t; = 20\n" -"st_atime\tresd\t1\t; = 24\n" -"st_atimensec\tresd\t1\t; = 28\n" -"st_mtime\tresd\t1\t; = 32\n" -"st_mtimensec\tresd\t1\t; = 36\n" -"st_ctime\tresd\t1\t; = 40\n" -"st_ctimensec\tresd\t1\t; = 44\n" -"st_size\t\tresd\t2\t; = 48, size is 64 bits\n" -"st_blocks\tresd\t2\t; = 56, ditto\n" -"st_blksize\tresd\t1\t; = 64\n" -"st_flags\tresd\t1\t; = 68\n" -"st_gen\t\tresd\t1\t; = 72\n" -"st_lspare\tresd\t1\t; = 76\n" -"st_qspare\tresd\t4\t; = 80\n" -"endstruc\n" -msgstr "" -";;;;;;; stat structure\n" -"struc\tstat\n" -"st_dev\t\tresd\t1\t; = 0\n" -"st_ino\t\tresd\t1\t; = 4\n" -"st_mode\t\tresw\t1\t; = 8, size is 16 bits\n" -"st_nlink\tresw\t1\t; = 10, ditto\n" -"st_uid\t\tresd\t1\t; = 12\n" -"st_gid\t\tresd\t1\t; = 16\n" -"st_rdev\t\tresd\t1\t; = 20\n" -"st_atime\tresd\t1\t; = 24\n" -"st_atimensec\tresd\t1\t; = 28\n" -"st_mtime\tresd\t1\t; = 32\n" -"st_mtimensec\tresd\t1\t; = 36\n" -"st_ctime\tresd\t1\t; = 40\n" -"st_ctimensec\tresd\t1\t; = 44\n" -"st_size\t\tresd\t2\t; = 48, size is 64 bits\n" -"st_blocks\tresd\t2\t; = 56, ditto\n" -"st_blksize\tresd\t1\t; = 64\n" -"st_flags\tresd\t1\t; = 68\n" -"st_gen\t\tresd\t1\t; = 72\n" -"st_lspare\tresd\t1\t; = 76\n" -"st_qspare\tresd\t4\t; = 80\n" -"endstruc\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1961 -msgid "We define the new syscalls:" -msgstr "Мы определяем новые системные вызовы:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1968 -#, no-wrap -msgid "" -"%define\tSYS_mmap\t197\n" -"%define\tSYS_munmap\t73\n" -"%define\tSYS_fstat\t189\n" -"%define\tSYS_ftruncate\t201\n" -msgstr "" -"%define\tSYS_mmap\t197\n" -"%define\tSYS_munmap\t73\n" -"%define\tSYS_fstat\t189\n" -"%define\tSYS_ftruncate\t201\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1971 -msgid "We add the macros for their use:" -msgstr "Добавляем макросы для их использования:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1977 -#, no-wrap -msgid "" -"%macro\tsys.mmap\t0\n" -"\tsystem\tSYS_mmap\n" -"%endmacro\n" -msgstr "" -"%macro\tsys.mmap\t0\n" -"\tsystem\tSYS_mmap\n" -"%endmacro\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1981 -#, no-wrap -msgid "" -"%macro\tsys.munmap\t0\n" -"\tsystem\tSYS_munmap\n" -"%endmacro\n" -msgstr "" -"%macro\tsys.munmap\t0\n" -"\tsystem\tSYS_munmap\n" -"%endmacro\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1985 -#, no-wrap -msgid "" -"%macro\tsys.ftruncate\t0\n" -"\tsystem\tSYS_ftruncate\n" -"%endmacro\n" -msgstr "" -"%macro\tsys.ftruncate\t0\n" -"\tsystem\tSYS_ftruncate\n" -"%endmacro\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1989 -#, no-wrap -msgid "" -"%macro\tsys.fstat\t0\n" -"\tsystem\tSYS_fstat\n" -"%endmacro\n" -msgstr "" -"%macro\tsys.fstat\t0\n" -"\tsystem\tSYS_fstat\n" -"%endmacro\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:1992 -msgid "And here is our code:" -msgstr "И вот наш код:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2005 -#, no-wrap -msgid "" -";;;;;;; Fast Text-to-Unix Conversion (ftuc.asm) ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -";;\n" -";; Started:\t21-Dec-2000\n" -";; Updated:\t22-Dec-2000\n" -";;\n" -";; Copyright 2000 G. Adam Stanislav.\n" -";; All rights reserved.\n" -";;\n" -";;;;;;; v.1 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -"%include\t'system.inc'\n" -msgstr "" -";;;;;;; Fast Text-to-Unix Conversion (ftuc.asm) ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -";;\n" -";; Started:\t21-Dec-2000\n" -";; Updated:\t22-Dec-2000\n" -";;\n" -";; Copyright 2000 G. Adam Stanislav.\n" -";; All rights reserved.\n" -";;\n" -";;;;;;; v.1 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -"%include\t'system.inc'\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2019 -#, no-wrap -msgid "" -"section\t.data\n" -"\tdb\t'Copyright 2000 G. Adam Stanislav.', 0Ah\n" -"\tdb\t'All rights reserved.', 0Ah\n" -"usg\tdb\t'Usage: ftuc filename', 0Ah\n" -"usglen\tequ\t$-usg\n" -"co\tdb\t\"ftuc: Can't open file.\", 0Ah\n" -"colen\tequ\t$-co\n" -"fae\tdb\t'ftuc: File access error.', 0Ah\n" -"faelen\tequ\t$-fae\n" -"ftl\tdb\t'ftuc: File too long, use regular tuc instead.', 0Ah\n" -"ftllen\tequ\t$-ftl\n" -"mae\tdb\t'ftuc: Memory allocation error.', 0Ah\n" -"maelen\tequ\t$-mae\n" -msgstr "" -"section\t.data\n" -"\tdb\t'Copyright 2000 G. Adam Stanislav.', 0Ah\n" -"\tdb\t'All rights reserved.', 0Ah\n" -"usg\tdb\t'Usage: ftuc filename', 0Ah\n" -"usglen\tequ\t$-usg\n" -"co\tdb\t\"ftuc: Can't open file.\", 0Ah\n" -"colen\tequ\t$-co\n" -"fae\tdb\t'ftuc: File access error.', 0Ah\n" -"faelen\tequ\t$-fae\n" -"ftl\tdb\t'ftuc: File too long, use regular tuc instead.', 0Ah\n" -"ftllen\tequ\t$-ftl\n" -"mae\tdb\t'ftuc: Memory allocation error.', 0Ah\n" -"maelen\tequ\t$-mae\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2021 -#, no-wrap -msgid "section\t.text\n" -msgstr "section\t.text\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2027 -#, no-wrap -msgid "" -"align 4\n" -"memerr:\n" -"\tpush\tdword maelen\n" -"\tpush\tdword mae\n" -"\tjmp\tshort error\n" -msgstr "" -"align 4\n" -"memerr:\n" -"\tpush\tdword maelen\n" -"\tpush\tdword mae\n" -"\tjmp\tshort error\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2033 -#, no-wrap -msgid "" -"align 4\n" -"toolong:\n" -"\tpush\tdword ftllen\n" -"\tpush\tdword ftl\n" -"\tjmp\tshort error\n" -msgstr "" -"align 4\n" -"toolong:\n" -"\tpush\tdword ftllen\n" -"\tpush\tdword ftl\n" -"\tjmp\tshort error\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2039 -#, no-wrap -msgid "" -"align 4\n" -"facerr:\n" -"\tpush\tdword faelen\n" -"\tpush\tdword fae\n" -"\tjmp\tshort error\n" -msgstr "" -"align 4\n" -"facerr:\n" -"\tpush\tdword faelen\n" -"\tpush\tdword fae\n" -"\tjmp\tshort error\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2045 -#, no-wrap -msgid "" -"align 4\n" -"cantopen:\n" -"\tpush\tdword colen\n" -"\tpush\tdword co\n" -"\tjmp\tshort error\n" -msgstr "" -"align 4\n" -"cantopen:\n" -"\tpush\tdword colen\n" -"\tpush\tdword co\n" -"\tjmp\tshort error\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2050 -#, no-wrap -msgid "" -"align 4\n" -"usage:\n" -"\tpush\tdword usglen\n" -"\tpush\tdword usg\n" -msgstr "" -"align 4\n" -"usage:\n" -"\tpush\tdword usglen\n" -"\tpush\tdword usg\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2054 -#, no-wrap -msgid "" -"error:\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" -msgstr "" -"error:\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2057 -#, no-wrap -msgid "" -"\tpush\tdword 1\n" -"\tsys.exit\n" -msgstr "" -"\tpush\tdword 1\n" -"\tsys.exit\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2065 -#, no-wrap -msgid "" -"align 4\n" -"global\t_start\n" -"_start:\n" -"\tpop\teax\t\t; argc\n" -"\tpop\teax\t\t; program name\n" -"\tpop\tecx\t\t; file to convert\n" -"\tjecxz\tusage\n" -msgstr "" -"align 4\n" -"global\t_start\n" -"_start:\n" -"\tpop\teax\t\t; argc\n" -"\tpop\teax\t\t; program name\n" -"\tpop\tecx\t\t; file to convert\n" -"\tjecxz\tusage\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2069 -#, no-wrap -msgid "" -"\tpop\teax\n" -"\tor\teax, eax\t; Too many arguments?\n" -"\tjne\tusage\n" -msgstr "" -"\tpop\teax\n" -"\tor\teax, eax\t; Too many arguments?\n" -"\tjne\tusage\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2075 -#, no-wrap -msgid "" -"\t; Open the file\n" -"\tpush\tdword O_RDWR\n" -"\tpush\tecx\n" -"\tsys.open\n" -"\tjc\tcantopen\n" -msgstr "" -"\t; Open the file\n" -"\tpush\tdword O_RDWR\n" -"\tpush\tecx\n" -"\tsys.open\n" -"\tjc\tcantopen\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2077 -#, no-wrap -msgid "\tmov\tebp, eax\t; Save fd\n" -msgstr "\tmov\tebp, eax\t; Save fd\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2080 -#, no-wrap -msgid "" -"\tsub\tesp, byte stat_size\n" -"\tmov\tebx, esp\n" -msgstr "" -"\tsub\tesp, byte stat_size\n" -"\tmov\tebx, esp\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2086 -#, no-wrap -msgid "" -"\t; Find file size\n" -"\tpush\tebx\n" -"\tpush\tebp\t\t; fd\n" -"\tsys.fstat\n" -"\tjc\tfacerr\n" -msgstr "" -"\t; Find file size\n" -"\tpush\tebx\n" -"\tpush\tebp\t\t; fd\n" -"\tsys.fstat\n" -"\tjc\tfacerr\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2088 -#, no-wrap -msgid "\tmov\tedx, [ebx + st_size + 4]\n" -msgstr "\tmov\tedx, [ebx + st_size + 4]\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2096 -#, no-wrap -msgid "" -"\t; File is too long if EDX != 0 ...\n" -"\tor\tedx, edx\n" -"\tjne\tnear toolong\n" -"\tmov\tecx, [ebx + st_size]\n" -"\t; ... or if it is above 2 GB\n" -"\tor\tecx, ecx\n" -"\tjs\tnear toolong\n" -msgstr "" -"\t; File is too long if EDX != 0 ...\n" -"\tor\tedx, edx\n" -"\tjne\tnear toolong\n" -"\tmov\tecx, [ebx + st_size]\n" -"\t; ... or if it is above 2 GB\n" -"\tor\tecx, ecx\n" -"\tjs\tnear toolong\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2099 -#, no-wrap -msgid "" -"\t; Do nothing if the file is 0 bytes in size\n" -"\tjecxz\t.quit\n" -msgstr "" -"\t; Do nothing if the file is 0 bytes in size\n" -"\tjecxz\t.quit\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2111 -#, no-wrap -msgid "" -"\t; Map the entire file in memory\n" -"\tpush\tedx\n" -"\tpush\tedx\t\t; starting at offset 0\n" -"\tpush\tedx\t\t; pad\n" -"\tpush\tebp\t\t; fd\n" -"\tpush\tdword MAP_SHARED\n" -"\tpush\tdword PROT_READ | PROT_WRITE\n" -"\tpush\tecx\t\t; entire file size\n" -"\tpush\tedx\t\t; let system decide on the address\n" -"\tsys.mmap\n" -"\tjc\tnear memerr\n" -msgstr "" -"\t; Map the entire file in memory\n" -"\tpush\tedx\n" -"\tpush\tedx\t\t; starting at offset 0\n" -"\tpush\tedx\t\t; pad\n" -"\tpush\tebp\t\t; fd\n" -"\tpush\tdword MAP_SHARED\n" -"\tpush\tdword PROT_READ | PROT_WRITE\n" -"\tpush\tecx\t\t; entire file size\n" -"\tpush\tedx\t\t; let system decide on the address\n" -"\tsys.mmap\n" -"\tjc\tnear memerr\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2116 -#, no-wrap -msgid "" -"\tmov\tedi, eax\n" -"\tmov\tesi, eax\n" -"\tpush\tecx\t\t; for SYS_munmap\n" -"\tpush\tedi\n" -msgstr "" -"\tmov\tedi, eax\n" -"\tmov\tesi, eax\n" -"\tpush\tecx\t\t; for SYS_munmap\n" -"\tpush\tedi\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2121 -#, no-wrap -msgid "" -"\t; Use EBX for state machine\n" -"\tmov\tebx, ordinary\n" -"\tmov\tah, 0Ah\n" -"\tcld\n" -msgstr "" -"\t; Use EBX for state machine\n" -"\tmov\tebx, ordinary\n" -"\tmov\tah, 0Ah\n" -"\tcld\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2126 -#, no-wrap -msgid "" -".loop:\n" -"\tlodsb\n" -"\tcall\tebx\n" -"\tloop\t.loop\n" -msgstr "" -".loop:\n" -"\tlodsb\n" -"\tcall\tebx\n" -"\tloop\t.loop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2129 -#, no-wrap -msgid "" -"\tcmp\tebx, ordinary\n" -"\tje\t.filesize\n" -msgstr "" -"\tcmp\tebx, ordinary\n" -"\tje\t.filesize\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2134 -#, no-wrap -msgid "" -"\t; Output final lf\n" -"\tmov\tal, ah\n" -"\tstosb\n" -"\tinc\tedx\n" -msgstr "" -"\t; Output final lf\n" -"\tmov\tal, ah\n" -"\tstosb\n" -"\tinc\tedx\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2142 -#, no-wrap -msgid "" -".filesize:\n" -"\t; truncate file to new size\n" -"\tpush\tdword 0\t\t; high dword\n" -"\tpush\tedx\t\t; low dword\n" -"\tpush\teax\t\t; pad\n" -"\tpush\tebp\n" -"\tsys.ftruncate\n" -msgstr "" -".filesize:\n" -"\t; truncate file to new size\n" -"\tpush\tdword 0\t\t; high dword\n" -"\tpush\tedx\t\t; low dword\n" -"\tpush\teax\t\t; pad\n" -"\tpush\tebp\n" -"\tsys.ftruncate\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2145 -#, no-wrap -msgid "" -"\t; close it (ebp still pushed)\n" -"\tsys.close\n" -msgstr "" -"\t; close it (ebp still pushed)\n" -"\tsys.close\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2148 -#, no-wrap -msgid "" -"\tadd\tesp, byte 16\n" -"\tsys.munmap\n" -msgstr "" -"\tadd\tesp, byte 16\n" -"\tsys.munmap\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2152 -#, no-wrap -msgid "" -".quit:\n" -"\tpush\tdword 0\n" -"\tsys.exit\n" -msgstr "" -".quit:\n" -"\tpush\tdword 0\n" -"\tsys.exit\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2157 -#, no-wrap -msgid "" -"align 4\n" -"ordinary:\n" -"\tcmp\tal, 0Dh\n" -"\tje\t.cr\n" -msgstr "" -"align 4\n" -"ordinary:\n" -"\tcmp\tal, 0Dh\n" -"\tje\t.cr\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2160 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2182 -#, no-wrap -msgid "" -"\tcmp\tal, ah\n" -"\tje\t.lf\n" -msgstr "" -"\tcmp\tal, ah\n" -"\tje\t.lf\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2164 -#, no-wrap -msgid "" -"\tstosb\n" -"\tinc\tedx\n" -"\tret\n" -msgstr "" -"\tstosb\n" -"\tinc\tedx\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2169 -#, no-wrap -msgid "" -"align 4\n" -".cr:\n" -"\tmov\tebx, cr\n" -"\tret\n" -msgstr "" -"align 4\n" -".cr:\n" -"\tmov\tebx, cr\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2174 -#, no-wrap -msgid "" -"align 4\n" -".lf:\n" -"\tmov\tebx, lf\n" -"\tret\n" -msgstr "" -"align 4\n" -".lf:\n" -"\tmov\tebx, lf\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2179 -#, no-wrap -msgid "" -"align 4\n" -"cr:\n" -"\tcmp\tal, 0Dh\n" -"\tje\t.cr\n" -msgstr "" -"align 4\n" -"cr:\n" -"\tcmp\tal, 0Dh\n" -"\tje\t.cr\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2186 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2214 -#, no-wrap -msgid "" -"\txchg\tal, ah\n" -"\tstosb\n" -"\tinc\tedx\n" -msgstr "" -"\txchg\tal, ah\n" -"\tstosb\n" -"\tinc\tedx\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2189 -#, no-wrap -msgid "" -"\txchg\tal, ah\n" -"\t; fall through\n" -msgstr "" -"\txchg\tal, ah\n" -"\t; fall through\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2195 -#, no-wrap -msgid "" -".lf:\n" -"\tstosb\n" -"\tinc\tedx\n" -"\tmov\tebx, ordinary\n" -"\tret\n" -msgstr "" -".lf:\n" -"\tstosb\n" -"\tinc\tedx\n" -"\tmov\tebx, ordinary\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2202 -#, no-wrap -msgid "" -"align 4\n" -".cr:\n" -"\tmov\tal, ah\n" -"\tstosb\n" -"\tinc\tedx\n" -"\tret\n" -msgstr "" -"align 4\n" -".cr:\n" -"\tmov\tal, ah\n" -"\tstosb\n" -"\tinc\tedx\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2207 -#, no-wrap -msgid "" -"align 4\n" -"lf:\n" -"\tcmp\tal, ah\n" -"\tje\t.lf\n" -msgstr "" -"align 4\n" -"lf:\n" -"\tcmp\tal, ah\n" -"\tje\t.lf\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2210 -#, no-wrap -msgid "" -"\tcmp\tal, 0Dh\n" -"\tje\t.cr\n" -msgstr "" -"\tcmp\tal, 0Dh\n" -"\tje\t.cr\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2220 -#, no-wrap -msgid "" -"\txchg\tal, ah\n" -"\tstosb\n" -"\tinc\tedx\n" -"\tmov\tebx, ordinary\n" -"\tret\n" -msgstr "" -"\txchg\tal, ah\n" -"\tstosb\n" -"\tinc\tedx\n" -"\tmov\tebx, ordinary\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2226 -#, no-wrap -msgid "" -"align 4\n" -".cr:\n" -"\tmov\tebx, ordinary\n" -"\tmov\tal, ah\n" -"\t; fall through\n" -msgstr "" -"align 4\n" -".cr:\n" -"\tmov\tebx, ordinary\n" -"\tmov\tal, ah\n" -"\t; fall through\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2231 -#, no-wrap -msgid "" -".lf:\n" -"\tstosb\n" -"\tinc\tedx\n" -"\tret\n" -msgstr "" -".lf:\n" -"\tstosb\n" -"\tinc\tedx\n" -"\tret\n" - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2238 -msgid "" -"Do not use this program on files stored on a disk formatted by MS-DOS(R) or " -"Windows(R). There seems to be a subtle bug in the FreeBSD code when using " -"`mmap` on these drives mounted under FreeBSD: If the file is over a certain " -"size, `mmap` will just fill the memory with zeros, and then copy them to the " -"file overwriting its contents." -msgstr "" -"Не используйте эту программу для файлов, хранящихся на диске, " -"отформатированном в MS-DOS(R) или Windows(R). В коде FreeBSD присутствует " -"неочевидная ошибка при использовании `mmap` на таких дисках, смонтированных " -"в FreeBSD: если размер файла превышает определённое значение, `mmap` " -"заполнит память нулями, а затем запишет их в файл, перезаписав его " -"содержимое." - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2241 -#, no-wrap -msgid "One-Pointed Mind" -msgstr "Спокойствие ума" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2244 -msgid "" -"As a student of Zen, I like the idea of a one-pointed mind: Do one thing at " -"a time, and do it well." -msgstr "" -"Как ученик дзэн, мне нравится идея спокойствия ума (экаггата): делай одно " -"дело за раз и делай его хорошо." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2247 -msgid "" -"This, indeed, is very much how UNIX(R) works as well. While a typical " -"Windows(R) application is attempting to do everything imaginable (and is, " -"therefore, riddled with bugs), a typical UNIX(R) program does only one " -"thing, and it does it well." -msgstr "" -"Вот именно так, в большинстве случаев, работает и UNIX(R). В то время как " -"типичное приложение Windows(R) пытается сделать всё, что только можно (и " -"поэтому кишит ошибками), типичная программа UNIX(R) делает только одну вещь, " -"но делает её хорошо." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2249 -msgid "" -"The typical UNIX(R) user then essentially assembles his own applications by " -"writing a shell script which combines the various existing programs by " -"piping the output of one program to the input of another." -msgstr "" -"Типичный пользователь UNIX(R) по сути собирает свои собственные приложения, " -"написав shell-скрипт, который объединяет различные существующие программы, " -"передавая вывод одной программы на вход другой." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2251 -msgid "" -"When writing your own UNIX(R) software, it is generally a good idea to see " -"what parts of the problem you need to solve can be handled by existing " -"programs, and only write your own programs for that part of the problem that " -"you do not have an existing solution for." -msgstr "" -"При написании собственного программного обеспечения для UNIX(R) обычно " -"рекомендуется определить, какие части решаемой задачи могут быть обработаны " -"существующими программами, и создавать собственные программы только для той " -"части задачи, для которой нет готового решения." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2253 -#, no-wrap -msgid "CSV" -msgstr "CSV" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2256 -msgid "" -"I will illustrate this principle with a specific real-life example I was " -"faced with recently:" -msgstr "" -"Я проиллюстрирую этот принцип конкретным примером из реальной жизни, с " -"которым недавно столкнулся:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2260 -msgid "" -"I needed to extract the 11th field of each record from a database I " -"downloaded from a web site. The database was a CSV file, i.e., a list of " -"_comma-separated values_. That is quite a standard format for sharing data " -"among people who may be using different database software." -msgstr "" -"Мне нужно было извлечь 11-е поле каждой записи из базы данных, которую я " -"загрузил с веб-сайта. База данных представляла собой CSV-файл, то есть " -"список _значений, разделённых запятыми_. Это довольно стандартный формат для " -"обмена данными между людьми, которые могут использовать разное программное " -"обеспечение для работы с базами данных." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2263 -msgid "" -"The first line of the file contains the list of various fields separated by " -"commas. The rest of the file contains the data listed line by line, with " -"values separated by commas." -msgstr "" -"Первая строка файла содержит список различных полей, разделенных запятыми. " -"Остальная часть файла содержит данные, перечисленные построчно, со " -"значениями, разделенными запятыми." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2265 -msgid "" -"I tried awk, using the comma as a separator. But because several lines " -"contained a quoted comma, awk was extracting the wrong field from those " -"lines." -msgstr "" -"Я попробовал awk, используя запятую в качестве разделителя. Но поскольку " -"несколько строк содержали запятую в кавычках, awk извлекал неправильное поле " -"из этих строк." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2268 -msgid "" -"Therefore, I needed to write my own software to extract the 11th field from " -"the CSV file. However, going with the UNIX(R) spirit, I only needed to " -"write a simple filter that would do the following:" -msgstr "" -"Следовательно, мне нужно было написать собственное программное обеспечение " -"для извлечения 11-го поля из CSV-файла. Однако, следуя духу UNIX(R), мне " -"нужно было лишь создать простой фильтр, выполняющий следующие действия:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2270 -msgid "Remove the first line from the file;" -msgstr "Удалить первую строку из файла;" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2271 -msgid "Change all unquoted commas to a different character;" -msgstr "Заменить все не заключённые в кавычки запятые на другой символ;" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2272 -msgid "Remove all quotation marks." -msgstr "Удалить все кавычки." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2274 -msgid "" -"Strictly speaking, I could use sed to remove the first line from the file, " -"but doing so in my own program was very easy, so I decided to do it and " -"reduce the size of the pipeline." -msgstr "" -"Строго говоря, я мог бы использовать sed для удаления первой строки из " -"файла, но сделать это в моей собственной программе было очень просто, " -"поэтому я решил так поступить и уменьшить размер конвейера." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2278 -msgid "" -"At any rate, writing a program like this took me about 20 minutes. Writing " -"a program that extracts the 11th field from the CSV file would take a lot " -"longer, and I could not reuse it to extract some other field from some other " -"database." -msgstr "" -"В любом случае, написание подобной программы заняло у меня около 20 минут. " -"Написание программы, которая извлекает 11-е поле из CSV-файла, заняло бы " -"гораздо больше времени, и я не смог бы повторно использовать её для " -"извлечения другого поля из другой базы данных." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2280 -msgid "" -"This time I decided to let it do a little more work than a typical tutorial " -"program would:" -msgstr "" -"На этот раз я решил позволить ей выполнить немного больше работы, чем " -"обычная учебная программа:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2282 -msgid "It parses its command line for options;" -msgstr "Она анализирует свою командную строку на наличие опций;" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2283 -msgid "It displays proper usage if it finds wrong arguments;" -msgstr "Она отображает подсказку, если обнаруживает неверные аргументы;" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2284 -msgid "It produces meaningful error messages." -msgstr "Она выдаёт понятные сообщения об ошибках." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2286 -msgid "Here is its usage message:" -msgstr "Вот какое сообщение она выводит о том, как её использовать:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2290 -#, no-wrap -msgid "Usage: csv [-t<delim>] [-c<comma>] [-p] [-o <outfile>] [-i <infile>]\n" -msgstr "Usage: csv [-t<delim>] [-c<comma>] [-p] [-o <outfile>] [-i <infile>]\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2293 -msgid "All parameters are optional, and can appear in any order." -msgstr "Все параметры необязательны и могут располагаться в любом порядке." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2297 -msgid "" -"The `-t` parameter declares what to replace the commas with. The `tab` is " -"the default here. For example, `-t;` will replace all unquoted commas with " -"semicolons." -msgstr "" -"Параметр `-t` указывает, на что заменить запятые. По умолчанию используется " -"`tab`. Например, `-t;` заменит все незакавыченные запятые на точку с запятой." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2301 -msgid "" -"I did not need the `-c` option, but it may come in handy in the future. It " -"lets me declare that I want a character other than a comma replaced with " -"something else. For example, `-c@` will replace all at signs (useful if you " -"want to split a list of email addresses to their user names and domains)." -msgstr "" -"Мне не понадобилась опция `-c`, но в будущем она может пригодиться. Она " -"позволяет указать, что я хочу заменить символ, отличный от запятой, на что-" -"то другое. Например, `-c@` заменит все знаки @ (полезно, если нужно " -"разделить список email-адресов на имена пользователей и домены)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2304 -msgid "" -"The `-p` option preserves the first line, i.e., it does not delete it. By " -"default, we delete the first line because in a CSV file it contains the " -"field names rather than data." -msgstr "" -"Опция `-p` сохраняет первую строку, т.е. не удаляет её. По умолчанию мы " -"удаляем первую строку, потому что в CSV-файле она содержит названия полей, а " -"не данные." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2307 -msgid "" -"The `-i` and `-o` options let me specify the input and the output files. " -"Defaults are [.filename]#stdin# and [.filename]#stdout#, so this is a " -"regular UNIX(R) filter." -msgstr "" -"Опции `-i` и `-o` позволяют указать входной и выходной файлы. По умолчанию " -"используются [.filename]#stdin# и [.filename]#stdout#, как обычно работает " -"стандартный фильтр UNIX(R)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2310 -msgid "" -"I made sure that both `-i filename` and `-ifilename` are accepted. I also " -"made sure that only one input and one output files may be specified." -msgstr "" -"Я убедился, что принимаются как `-i filename`, так и `-ifilename`. Также я " -"убедился, что может быть указан только один входной и один выходной файл." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2312 -msgid "To get the 11th field of each record, I can now do:" -msgstr "Чтобы получить 11-е поле каждой записи, теперь я могу сделать:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2316 -#, no-wrap -msgid "% csv '-t;' data.csv | awk '-F;' '{print $11}'\n" -msgstr "% csv '-t;' data.csv | awk '-F;' '{print $11}'\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2319 -msgid "" -"The code stores the options (except for the file descriptors) in `EDX`: The " -"comma in `DH`, the new separator in `DL`, and the flag for the `-p` option " -"in the highest bit of `EDX`, so a check for its sign will give us a quick " -"decision what to do." -msgstr "" -"Код сохраняет параметры (за исключением файловых дескрипторов) в `EDX`: " -"запятая в `DH`, новый разделитель в `DL`, а флаг параметра `-p` в старшем " -"бите `EDX`, поэтому проверка его знака даст нам быстрое решение о дальнейших " -"действиях." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2321 -msgid "Here is the code:" -msgstr "Вот код:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2335 -#, no-wrap -msgid "" -";;;;;;; csv.asm ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -";\n" -"; Convert a comma-separated file to a something-else separated file.\n" -";\n" -"; Started:\t31-May-2001\n" -"; Updated:\t 1-Jun-2001\n" -";\n" -"; Copyright (c) 2001 G. Adam Stanislav\n" -"; All rights reserved.\n" -";\n" -";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -msgstr "" -";;;;;;; csv.asm ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -";\n" -"; Convert a comma-separated file to a something-else separated file.\n" -";\n" -"; Started:\t31-May-2001\n" -"; Updated:\t 1-Jun-2001\n" -";\n" -"; Copyright (c) 2001 G. Adam Stanislav\n" -"; All rights reserved.\n" -";\n" -";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2349 -#, no-wrap -msgid "" -"section\t.data\n" -"fd.in\tdd\tstdin\n" -"fd.out\tdd\tstdout\n" -"usg\tdb\t'Usage: csv [-t<delim>] [-c<comma>] [-p] [-o <outfile>] [-i <infile>]', 0Ah\n" -"usglen\tequ\t$-usg\n" -"iemsg\tdb\t\"csv: Can't open input file\", 0Ah\n" -"iemlen\tequ\t$-iemsg\n" -"oemsg\tdb\t\"csv: Can't create output file\", 0Ah\n" -"oemlen\tequ\t$-oemsg\n" -msgstr "" -"section\t.data\n" -"fd.in\tdd\tstdin\n" -"fd.out\tdd\tstdout\n" -"usg\tdb\t'Usage: csv [-t<delim>] [-c<comma>] [-p] [-o <outfile>] [-i <infile>]', 0Ah\n" -"usglen\tequ\t$-usg\n" -"iemsg\tdb\t\"csv: Can't open input file\", 0Ah\n" -"iemlen\tequ\t$-iemsg\n" -"oemsg\tdb\t\"csv: Can't create output file\", 0Ah\n" -"oemlen\tequ\t$-oemsg\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2363 -#, no-wrap -msgid "" -"section\t.text\n" -"align 4\n" -"ierr:\n" -"\tpush\tdword iemlen\n" -"\tpush\tdword iemsg\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" -"\tpush\tdword 1\t\t; return failure\n" -"\tsys.exit\n" -msgstr "" -"section\t.text\n" -"align 4\n" -"ierr:\n" -"\tpush\tdword iemlen\n" -"\tpush\tdword iemsg\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" -"\tpush\tdword 1\t\t; return failure\n" -"\tsys.exit\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2372 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3421 -#, no-wrap -msgid "" -"align 4\n" -"oerr:\n" -"\tpush\tdword oemlen\n" -"\tpush\tdword oemsg\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" -"\tpush\tdword 2\n" -"\tsys.exit\n" -msgstr "" -"align 4\n" -"oerr:\n" -"\tpush\tdword oemlen\n" -"\tpush\tdword oemsg\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" -"\tpush\tdword 2\n" -"\tsys.exit\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2381 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3430 -#, no-wrap -msgid "" -"align 4\n" -"usage:\n" -"\tpush\tdword usglen\n" -"\tpush\tdword usg\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" -"\tpush\tdword 3\n" -"\tsys.exit\n" -msgstr "" -"align 4\n" -"usage:\n" -"\tpush\tdword usglen\n" -"\tpush\tdword usg\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" -"\tpush\tdword 3\n" -"\tsys.exit\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2387 -#, no-wrap -msgid "" -"align 4\n" -"global\t_start\n" -"_start:\n" -"\tadd\tesp, byte 8\t; discard argc and argv[0]\n" -"\tmov\tedx, (',' << 8) | 9\n" -msgstr "" -"align 4\n" -"global\t_start\n" -"_start:\n" -"\tadd\tesp, byte 8\t; discard argc and argv[0]\n" -"\tmov\tedx, (',' << 8) | 9\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2392 -#, no-wrap -msgid "" -".arg:\n" -"\tpop\tecx\n" -"\tor\tecx, ecx\n" -"\tje\tnear .init\t\t; no more arguments\n" -msgstr "" -".arg:\n" -"\tpop\tecx\n" -"\tor\tecx, ecx\n" -"\tje\tnear .init\t\t; no more arguments\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2396 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3445 -#, no-wrap -msgid "" -"\t; ECX contains the pointer to an argument\n" -"\tcmp\tbyte [ecx], '-'\n" -"\tjne\tusage\n" -msgstr "" -"\t; ECX contains the pointer to an argument\n" -"\tcmp\tbyte [ecx], '-'\n" -"\tjne\tusage\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2399 -#, no-wrap -msgid "" -"\tinc\tecx\n" -"\tmov\tax, [ecx]\n" -msgstr "" -"\tinc\tecx\n" -"\tmov\tax, [ecx]\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2403 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3453 -#, no-wrap -msgid "" -".o:\n" -"\tcmp\tal, 'o'\n" -"\tjne\t.i\n" -msgstr "" -".o:\n" -"\tcmp\tal, 'o'\n" -"\tjne\t.i\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2407 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3457 -#, no-wrap -msgid "" -"\t; Make sure we are not asked for the output file twice\n" -"\tcmp\tdword [fd.out], stdout\n" -"\tjne\tusage\n" -msgstr "" -"\t; Make sure we are not asked for the output file twice\n" -"\tcmp\tdword [fd.out], stdout\n" -"\tjne\tusage\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2412 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3462 -#, no-wrap -msgid "" -"\t; Find the path to output file - it is either at [ECX+1],\n" -"\t; i.e., -ofile --\n" -"\t; or in the next argument,\n" -"\t; i.e., -o file\n" -msgstr "" -"\t; Find the path to output file - it is either at [ECX+1],\n" -"\t; i.e., -ofile --\n" -"\t; or in the next argument,\n" -"\t; i.e., -o file\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2418 -#, no-wrap -msgid "" -"\tinc\tecx\n" -"\tor\tah, ah\n" -"\tjne\t.openoutput\n" -"\tpop\tecx\n" -"\tjecxz\tusage\n" -msgstr "" -"\tinc\tecx\n" -"\tor\tah, ah\n" -"\tjne\t.openoutput\n" -"\tpop\tecx\n" -"\tjecxz\tusage\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2426 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3475 -#, no-wrap -msgid "" -".openoutput:\n" -"\tpush\tdword 420\t; file mode (644 octal)\n" -"\tpush\tdword 0200h | 0400h | 01h\n" -"\t; O_CREAT | O_TRUNC | O_WRONLY\n" -"\tpush\tecx\n" -"\tsys.open\n" -"\tjc\tnear oerr\n" -msgstr "" -".openoutput:\n" -"\tpush\tdword 420\t; file mode (644 octal)\n" -"\tpush\tdword 0200h | 0400h | 01h\n" -"\t; O_CREAT | O_TRUNC | O_WRONLY\n" -"\tpush\tecx\n" -"\tsys.open\n" -"\tjc\tnear oerr\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2430 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3479 -#, no-wrap -msgid "" -"\tadd\tesp, byte 12\n" -"\tmov\t[fd.out], eax\n" -"\tjmp\tshort .arg\n" -msgstr "" -"\tadd\tesp, byte 12\n" -"\tmov\t[fd.out], eax\n" -"\tjmp\tshort .arg\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2434 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3483 -#, no-wrap -msgid "" -".i:\n" -"\tcmp\tal, 'i'\n" -"\tjne\t.p\n" -msgstr "" -".i:\n" -"\tcmp\tal, 'i'\n" -"\tjne\t.p\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2438 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3487 -#, no-wrap -msgid "" -"\t; Make sure we are not asked twice\n" -"\tcmp\tdword [fd.in], stdin\n" -"\tjne\tnear usage\n" -msgstr "" -"\t; Make sure we are not asked twice\n" -"\tcmp\tdword [fd.in], stdin\n" -"\tjne\tnear usage\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2446 -#, no-wrap -msgid "" -"\t; Find the path to the input file\n" -"\tinc\tecx\n" -"\tor\tah, ah\n" -"\tjne\t.openinput\n" -"\tpop\tecx\n" -"\tor\tecx, ecx\n" -"\tje near usage\n" -msgstr "" -"\t; Find the path to the input file\n" -"\tinc\tecx\n" -"\tor\tah, ah\n" -"\tjne\t.openinput\n" -"\tpop\tecx\n" -"\tor\tecx, ecx\n" -"\tje near usage\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2452 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3500 -#, no-wrap -msgid "" -".openinput:\n" -"\tpush\tdword 0\t\t; O_RDONLY\n" -"\tpush\tecx\n" -"\tsys.open\n" -"\tjc\tnear ierr\t\t; open failed\n" -msgstr "" -".openinput:\n" -"\tpush\tdword 0\t\t; O_RDONLY\n" -"\tpush\tecx\n" -"\tsys.open\n" -"\tjc\tnear ierr\t\t; open failed\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2456 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3504 -#, no-wrap -msgid "" -"\tadd\tesp, byte 8\n" -"\tmov\t[fd.in], eax\n" -"\tjmp\t.arg\n" -msgstr "" -"\tadd\tesp, byte 8\n" -"\tmov\t[fd.in], eax\n" -"\tjmp\t.arg\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2464 -#, no-wrap -msgid "" -".p:\n" -"\tcmp\tal, 'p'\n" -"\tjne\t.t\n" -"\tor\tah, ah\n" -"\tjne\tnear usage\n" -"\tor\tedx, 1 << 31\n" -"\tjmp\t.arg\n" -msgstr "" -".p:\n" -"\tcmp\tal, 'p'\n" -"\tjne\t.t\n" -"\tor\tah, ah\n" -"\tjne\tnear usage\n" -"\tor\tedx, 1 << 31\n" -"\tjmp\t.arg\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2472 -#, no-wrap -msgid "" -".t:\n" -"\tcmp\tal, 't'\t\t; redefine output delimiter\n" -"\tjne\t.c\n" -"\tor\tah, ah\n" -"\tje\tnear usage\n" -"\tmov\tdl, ah\n" -"\tjmp\t.arg\n" -msgstr "" -".t:\n" -"\tcmp\tal, 't'\t\t; redefine output delimiter\n" -"\tjne\t.c\n" -"\tor\tah, ah\n" -"\tje\tnear usage\n" -"\tmov\tdl, ah\n" -"\tjmp\t.arg\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2480 -#, no-wrap -msgid "" -".c:\n" -"\tcmp\tal, 'c'\n" -"\tjne\tnear usage\n" -"\tor\tah, ah\n" -"\tje\tnear usage\n" -"\tmov\tdh, ah\n" -"\tjmp\t.arg\n" -msgstr "" -".c:\n" -"\tcmp\tal, 'c'\n" -"\tjne\tnear usage\n" -"\tor\tah, ah\n" -"\tje\tnear usage\n" -"\tmov\tdh, ah\n" -"\tjmp\t.arg\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2487 -#, no-wrap -msgid "" -"align 4\n" -".init:\n" -"\tsub\teax, eax\n" -"\tsub\tebx, ebx\n" -"\tsub\tecx, ecx\n" -"\tmov\tedi, obuffer\n" -msgstr "" -"align 4\n" -".init:\n" -"\tsub\teax, eax\n" -"\tsub\tebx, ebx\n" -"\tsub\tecx, ecx\n" -"\tmov\tedi, obuffer\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2491 -#, no-wrap -msgid "" -"\t; See if we are to preserve the first line\n" -"\tor\tedx, edx\n" -"\tjs\t.loop\n" -msgstr "" -"\t; See if we are to preserve the first line\n" -"\tor\tedx, edx\n" -"\tjs\t.loop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2497 -#, no-wrap -msgid "" -".firstline:\n" -"\t; get rid of the first line\n" -"\tcall\tgetchar\n" -"\tcmp\tal, 0Ah\n" -"\tjne\t.firstline\n" -msgstr "" -".firstline:\n" -"\t; get rid of the first line\n" -"\tcall\tgetchar\n" -"\tcmp\tal, 0Ah\n" -"\tjne\t.firstline\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2505 -#, no-wrap -msgid "" -"\t; is it a comma (or whatever the user asked for)?\n" -"\tcmp\tal, dh\n" -"\tjne\t.quote\n" -msgstr "" -"\t; is it a comma (or whatever the user asked for)?\n" -"\tcmp\tal, dh\n" -"\tjne\t.quote\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2508 -#, no-wrap -msgid "" -"\t; Replace the comma with a tab (or whatever the user wants)\n" -"\tmov\tal, dl\n" -msgstr "" -"\t; Replace the comma with a tab (or whatever the user wants)\n" -"\tmov\tal, dl\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2516 -#, no-wrap -msgid "" -".quote:\n" -"\tcmp\tal, '\"'\n" -"\tjne\t.put\n" -msgstr "" -".quote:\n" -"\tcmp\tal, '\"'\n" -"\tjne\t.put\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2523 -#, no-wrap -msgid "" -"\t; Print everything until you get another quote or EOL. If it\n" -"\t; is a quote, skip it. If it is EOL, print it.\n" -".qloop:\n" -"\tcall\tgetchar\n" -"\tcmp\tal, '\"'\n" -"\tje\t.loop\n" -msgstr "" -"\t; Print everything until you get another quote or EOL. If it\n" -"\t; is a quote, skip it. If it is EOL, print it.\n" -".qloop:\n" -"\tcall\tgetchar\n" -"\tcmp\tal, '\"'\n" -"\tje\t.loop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2526 -#, no-wrap -msgid "" -"\tcmp\tal, 0Ah\n" -"\tje\t.put\n" -msgstr "" -"\tcmp\tal, 0Ah\n" -"\tje\t.put\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2529 -#, no-wrap -msgid "" -"\tcall\tputchar\n" -"\tjmp\tshort .qloop\n" -msgstr "" -"\tcall\tputchar\n" -"\tjmp\tshort .qloop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2545 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3860 -#, no-wrap -msgid "" -"read:\n" -"\tjecxz\t.read\n" -"\tcall\twrite\n" -msgstr "" -"read:\n" -"\tjecxz\t.read\n" -"\tcall\twrite\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2558 -#, no-wrap -msgid "" -".read:\n" -"\tpush\tdword BUFSIZE\n" -"\tmov\tesi, ibuffer\n" -"\tpush\tesi\n" -"\tpush\tdword [fd.in]\n" -"\tsys.read\n" -"\tadd\tesp, byte 12\n" -"\tmov\tebx, eax\n" -"\tor\teax, eax\n" -"\tje\t.done\n" -"\tsub\teax, eax\n" -"\tret\n" -msgstr "" -".read:\n" -"\tpush\tdword BUFSIZE\n" -"\tmov\tesi, ibuffer\n" -"\tpush\tesi\n" -"\tpush\tdword [fd.in]\n" -"\tsys.read\n" -"\tadd\tesp, byte 12\n" -"\tmov\tebx, eax\n" -"\tor\teax, eax\n" -"\tje\t.done\n" -"\tsub\teax, eax\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2595 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3901 -#, no-wrap -msgid "" -"align 4\n" -"write:\n" -"\tjecxz\t.ret\t; nothing to write\n" -"\tsub\tedi, ecx\t; start of buffer\n" -"\tpush\tecx\n" -"\tpush\tedi\n" -"\tpush\tdword [fd.out]\n" -"\tsys.write\n" -"\tadd\tesp, byte 12\n" -"\tsub\teax, eax\n" -"\tsub\tecx, ecx\t; buffer is empty now\n" -".ret:\n" -"\tret\n" -msgstr "" -"align 4\n" -"write:\n" -"\tjecxz\t.ret\t; nothing to write\n" -"\tsub\tedi, ecx\t; start of buffer\n" -"\tpush\tecx\n" -"\tpush\tedi\n" -"\tpush\tdword [fd.out]\n" -"\tsys.write\n" -"\tadd\tesp, byte 12\n" -"\tsub\teax, eax\n" -"\tsub\tecx, ecx\t; buffer is empty now\n" -".ret:\n" -"\tret\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2600 -msgid "" -"Much of it is taken from [.filename]#hex.asm# above. But there is one " -"important difference: I no longer call `write` whenever I am outputting a " -"line feed. Yet, the code can be used interactively." -msgstr "" -"Большая часть взята из [.filename]#hex.asm# выше. Однако есть одно важное " -"отличие: я больше не вызываю `write` каждый раз при выводе перевода строки. " -"Тем не менее, код можно использовать интерактивно." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2604 -msgid "" -"I have found a better solution for the interactive problem since I first " -"started writing this chapter. I wanted to make sure each line is printed " -"out separately only when needed. After all, there is no need to flush out " -"every line when used non-interactively." -msgstr "" -"Я нашел лучшее решение для интерактивной проблемы с тех пор, как начал " -"писать эту главу. Я хотел убедиться, что каждая строка выводится отдельно " -"только при необходимости. В конце концов, нет необходимости выводить каждую " -"строку при неинтерактивном использовании." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2608 -msgid "" -"The new solution I use now is to call `write` every time I find the input " -"buffer empty. That way, when running in the interactive mode, the program " -"reads one line from the user's keyboard, processes it, and sees its input " -"buffer is empty. It flushes its output and reads the next line." -msgstr "" -"Новое решение, которое я использую сейчас, заключается в вызове `write` " -"каждый раз, когда обнаруживаю, что входной буфер пуст. Таким образом, при " -"работе в интерактивном режиме программа считывает одну строку с клавиатуры " -"пользователя, обрабатывает её и видит, что входной буфер пуст. Она " -"сбрасывает свой вывод и читает следующую строку." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2610 -#, no-wrap -msgid "The Dark Side of Buffering" -msgstr "Темная сторона буферизации" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2614 -msgid "" -"This change prevents a mysterious lockup in a very specific case. I refer " -"to it as the _dark side of buffering_, mostly because it presents a danger " -"that is not quite obvious." -msgstr "" -"Это изменение предотвращает загадочную блокировку в очень специфическом " -"случае. Я называю это _тёмной стороной буферизации_, в основном потому, что " -"это представляет опасность, которая не совсем очевидна." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2618 -msgid "" -"It is unlikely to happen with a program like the csv above, so let us " -"consider yet another filter: In this case we expect our input to be raw data " -"representing color values, such as the _red_, _green_, and _blue_ " -"intensities of a pixel. Our output will be the negative of our input." -msgstr "" -"Маловероятно, что это произойдет с такой программой, как csv выше, поэтому " -"рассмотрим ещё один фильтр: в этом случае мы ожидаем, что наши входные " -"данные будут представлять собой необработанные данные, описывающие значения " -"цветов, такие как интенсивности _красного_, _зеленого_ и _синего_ для " -"пикселя. На выходе мы получим негатив входных данных." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2621 -msgid "" -"Such a filter would be very simple to write. Most of it would look just " -"like all the other filters we have written so far, so I am only going to " -"show you its inner loop:" -msgstr "" -"Такой фильтр было бы очень просто написать. Большая его часть выглядела бы " -"так же, как и все другие фильтры, которые мы уже писали, поэтому я покажу " -"только его внутренний цикл:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2629 -#, no-wrap -msgid "" -".loop:\n" -"\tcall\tgetchar\n" -"\tnot\tal\t\t; Create a negative\n" -"\tcall\tputchar\n" -"\tjmp\tshort .loop\n" -msgstr "" -".loop:\n" -"\tcall\tgetchar\n" -"\tnot\tal\t\t; Create a negative\n" -"\tcall\tputchar\n" -"\tjmp\tshort .loop\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2632 -msgid "" -"Because this filter works with raw data, it is unlikely to be used " -"interactively." -msgstr "" -"Поскольку этот фильтр работает с необработанными данными, он вряд ли будет " -"использоваться интерактивно." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2635 -msgid "" -"But it could be called by image manipulation software. And, unless it calls " -"`write` before each call to `read`, chances are it will lock up." -msgstr "" -"Но он может вызываться программным обеспечением для обработки изображений. " -"И, если он не вызывает `write` перед каждым вызовом `read`, высока " -"вероятность, что он зависнет." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2637 -msgid "Here is what might happen:" -msgstr "Вот что может произойти:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2640 -msgid "The image editor will load our filter using the C function `popen()`." -msgstr "" -"Редактор изображений загрузит наш фильтр, используя функцию `popen()` на " -"языке C." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2641 -msgid "It will read the first row of pixels from a bitmap or pixmap." -msgstr "" -"Он прочитает первый ряд пикселей из битовой карты или пиксельной карты." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2642 -msgid "" -"It will write the first row of pixels to the _pipe_ leading to the `fd.in` " -"of our filter." -msgstr "" -"Он запишет первую строку пикселей в _канал_, ведущий к `fd.in` нашего " -"фильтра." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2643 -msgid "" -"Our filter will read each pixel from its input, turn it to a negative, and " -"write it to its output buffer." -msgstr "" -"Наш фильтр будет читать каждый пиксель из входных данных, преобразовывать " -"его в негатив и записывать в выходной буфер." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2644 -msgid "Our filter will call `getchar` to fetch the next pixel." -msgstr "Наш фильтр будет вызывать `getchar` для получения следующего пикселя." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2645 -msgid "`getchar` will find an empty input buffer, so it will call `read`." -msgstr "`getchar` обнаружит пустой входной буфер, поэтому вызовет `read`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2646 -msgid "`read` will call the `SYS_read` system call." -msgstr "`read` вызовет системный вызов `SYS_read`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2647 -msgid "" -"The _kernel_ will suspend our filter until the image editor sends more data " -"to the pipe." -msgstr "" -"_Ядро_ приостановит работу нашего фильтра до тех пор, пока редактор " -"изображений не отправит больше данных в канал." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2648 -msgid "" -"The image editor will read from the other pipe, connected to the `fd.out` of " -"our filter so it can set the first row of the output image _before_ it sends " -"us the second row of the input." -msgstr "" -"Редактор изображений будет читать из другого канала, подключенного к `fd." -"out` нашего фильтра, чтобы он мог установить первую строку выходного " -"изображения _до_ того, как отправит нам вторую строку входного." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2649 -msgid "" -"The _kernel_ suspends the image editor until it receives some output from " -"our filter, so it can pass it on to the image editor." -msgstr "" -"_Ядро_ приостанавливает работу графического редактора до тех пор, пока не " -"получит какие-либо данные от нашего фильтра, чтобы передать их редактору." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2653 -msgid "" -"At this point our filter waits for the image editor to send it more data to " -"process, while the image editor is waiting for our filter to send it the " -"result of the processing of the first row. But the result sits in our " -"output buffer." -msgstr "" -"На этом этапе наш фильтр ожидает, что редактор изображений отправит ему " -"больше данных для обработки, в то время как редактор изображений ожидает, " -"что наш фильтр отправит ему результат обработки первой строки. Однако " -"результат находится в нашем выходном буфере." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2656 -msgid "" -"The filter and the image editor will continue waiting for each other forever " -"(or, at least, until they are killed). Our software has just entered a " -"crossref:secure[secure-race-conditions,race condition]." -msgstr "" -"Фильтр и редактор изображений будут продолжать ждать друг друга вечно (или, " -"по крайней мере, пока их не завершат командой kill). Наше программное " -"обеспечение только что вошло в crossref:secure[secure-race-conditions," -"состояние гонки]." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2658 -msgid "" -"This problem does not exist if our filter flushes its output buffer _before_ " -"asking the _kernel_ for more input data." -msgstr "" -"Эта проблема не возникает, если наш фильтр очищает свой выходной буфер " -"_перед_ запросом к _ядру_ для получения дополнительных входных данных." - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2660 -#, no-wrap -msgid "Using the FPU" -msgstr "Использование FPU" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2663 -msgid "" -"Strangely enough, most of assembly language literature does not even mention " -"the existence of the FPU, or _floating point unit_, let alone discuss " -"programming it." -msgstr "" -"Как ни странно, большая часть литературы по ассемблеру даже не упоминает о " -"существовании FPU, или _блока обработки чисел с плавающей запятой_, не " -"говоря уже о программировании для него." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2665 -msgid "" -"Yet, never does assembly language shine more than when we create highly " -"optimized FPU code by doing things that can be done _only_ in assembly " -"language." -msgstr "" -"Тем не менее, язык ассемблера проявляет себя наилучшим образом, когда мы " -"создаем высокооптимизированный код для FPU, выполняя вещи, которые можно " -"сделать _только_ на языке ассемблера." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2667 -#, no-wrap -msgid "Organization of the FPU" -msgstr "Организация FPU" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2671 -msgid "" -"The FPU consists of 8 80-bit floating-point registers. These are organized " -"in a stack fashion-you can `push` a value on TOS (_top of stack_) and you " -"can `pop` it." -msgstr "" -"FPU состоит из 8 80-битных регистров с плавающей запятой. Они организованы в " -"виде стека — вы можете `push` (поместить) значение на TOS (_вершина стека_) " -"и `pop` (извлечь) его." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2673 -msgid "" -"That said, the assembly language op codes are not `push` and `pop` because " -"those are already taken." -msgstr "" -"Как бы то ни было, мнемоники ассемблера — не `push` и `pop`, потому что они " -"уже заняты." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2676 -msgid "" -"You can `push` a value on TOS by using `fld`, `fild`, and `fbld`. Several " -"other op codes let you `push` many common _constants_-such as _pi_-on the " -"TOS." -msgstr "" -"Вы можете `push` (положить) значение на вершину стека (TOS), используя " -"`fld`, `fild` и `fbld`. Несколько других кодов операций позволяют вам `push` " -"(положить) многие распространённые _константы_ — например, _pi_ — на вершину " -"стека (TOS)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2679 -msgid "" -"Similarly, you can `pop` a value by using `fst`, `fstp`, `fist`, `fistp`, " -"and `fbstp`. Actually, only the op codes that end with a _p_ will literally " -"`pop` the value, the rest will `store` it somewhere else without removing it " -"from the TOS." -msgstr "" -"Аналогично, вы можете `извлечь` значение с помощью `fst`, `fstp`, `fist`, " -"`fistp` и `fbstp`. На самом деле только коды операций, оканчивающиеся на " -"_p_, буквально `извлекают` значение, остальные же `сохраняют` его в другом " -"месте, не удаляя с вершины стека (TOS)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2681 -msgid "" -"We can transfer the data between the TOS and the computer memory either as a " -"32-bit, 64-bit, or 80-bit _real_, a 16-bit, 32-bit, or 64-bit _integer_, or " -"an 80-bit _packed decimal_." -msgstr "" -"Мы можем передавать данные между TOS и памятью компьютера либо как 32-" -"битное, 64-битное или 80-битное _вещественное_ число, 16-битное, 32-битное " -"или 64-битное _целое_ число, либо как 80-битное _упакованное десятичное_ " -"число." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2684 -msgid "" -"The 80-bit _packed decimal_ is a special case of _binary coded decimal_ " -"which is very convenient when converting between the ASCII representation of " -"data and the internal data of the FPU. It allows us to use 18 significant " -"digits." -msgstr "" -"80-битный _упакованный десятичный_ формат является особым случаем _двоично-" -"десятичного кодирования_, который очень удобен при преобразовании между " -"ASCII-представлением данных и внутренними данными FPU. Он позволяет " -"использовать до 18 значащих цифр." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2686 -msgid "" -"No matter how we represent data in the memory, the FPU always stores it in " -"the 80-bit _real_ format in its registers." -msgstr "" -"Независимо от того, как мы представляем данные в памяти, FPU всегда хранит " -"их в 80-битном формате _real_ в своих регистрах." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2688 -msgid "" -"Its internal precision is at least 19 decimal digits, so even if we choose " -"to display results as ASCII in the full 18-digit precision, we are still " -"showing correct results." -msgstr "" -"Его внутренняя точность составляет не менее 19 десятичных цифр, поэтому даже " -"если мы решим отображать результаты в формате ASCII с полной 18-значной " -"точностью, мы всё равно будем показывать корректные результаты." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2690 -msgid "" -"We can perform mathematical operations on the TOS: We can calculate its " -"_sine_, we can _scale_ it (i.e., we can multiply or divide it by a power of " -"2), we can calculate its base-2 _logarithm_, and many other things." -msgstr "" -"Мы можем выполнять математические операции над TOS: вычислять его _синус_, " -"_масштабировать_ (то есть умножать или делить на степень двойки), вычислять " -"его _логарифм_ по основанию 2 и многое другое." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2692 -msgid "" -"We can also _multiply_ or _divide_ it by, _add_ it to, or _subtract_ it " -"from, any of the FPU registers (including itself)." -msgstr "" -"Мы также можем _умножить_ или _разделить_ его, _прибавить_ к нему или " -"_вычесть_ его из любого из регистров FPU (включая его самого)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2695 -msgid "" -"The official Intel op code for the TOS is `st`, and for the _registers_ " -"`st(0)`-`st(7)`. `st` and `st(0)`, then, refer to the same register." -msgstr "" -"Официальный код операции Intel для TOS — `st`, а для _регистров_ — `st(0)`-" -"`st(7)`. Таким образом, `st` и `st(0)` ссылаются на один и тот же регистр." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2698 -msgid "" -"For whatever reasons, the original author of nasm has decided to use " -"different op codes, namely `st0`-`st7`. In other words, there are no " -"parentheses, and the TOS is always `st0`, never just `st`." -msgstr "" -"По каким-то причинам оригинальный автор nasm решил использовать другие коды " -"операций, а именно `st0`-`st7`. Другими словами, скобки отсутствуют, а " -"вершина стека всегда `st0`, но никогда просто `st`." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2700 -#, no-wrap -msgid "The Packed Decimal Format" -msgstr "Формат упакованного десятичного числа" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2704 -msgid "" -"The _packed decimal_ format uses 10 bytes (80 bits) of memory to represent " -"18 digits. The number represented there is always an _integer_." -msgstr "" -"Формат _упакованного десятичного числа_ использует 10 байт (80 бит) памяти " -"для представления 18 цифр. Представленное число всегда является _целым_." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2708 -msgid "" -"You can use it to get decimal places by multiplying the TOS by a power of 10 " -"first." -msgstr "" -"Вы можете использовать это для получения десятичных знаков, предварительно " -"умножив TOS на степень 10." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2712 -msgid "" -"The highest bit of the highest byte (byte 9) is the _sign bit_: If it is " -"set, the number is _negative_, otherwise, it is _positive_. The rest of the " -"bits of this byte are unused/ignored." -msgstr "" -"Старший бит старшего байта (байт 9) является _знаковым битом_: если он " -"установлен, число _отрицательное_, в противном случае — _положительное_. " -"Остальные биты этого байта не используются/игнорируются." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2714 -msgid "" -"The remaining 9 bytes store the 18 digits of the number: 2 digits per byte." -msgstr "Оставшиеся 9 байт хранят 18 цифр числа: 2 цифры на байт." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2716 -msgid "" -"The _more significant digit_ is stored in the high _nibble_ (4 bits), the " -"_less significant digit_ in the low _nibble_." -msgstr "" -"_Старший разряд_ хранится в старшем _полубайте_ (4 бита), _младший разряд_ — " -"в младшем _полубайте_." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2718 -msgid "" -"That said, you might think that `-1234567` would be stored in the memory " -"like this (using hexadecimal notation):" -msgstr "" -"Как бы то ни было, вы можете подумать, что `-1234567` будет храниться в " -"памяти следующим образом (в шестнадцатеричной записи):" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2722 -#, no-wrap -msgid "80 00 00 00 00 00 01 23 45 67\n" -msgstr "80 00 00 00 00 00 01 23 45 67\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2725 -msgid "" -"Alas it is not! As with everything else of Intel make, even the _packed " -"decimal_ is _little-endian_." -msgstr "" -"Увы, это не так! Как и все остальное, созданное Intel, даже _упакованное " -"десятичное число_ имеет порядок _от младшего к старшему_." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2727 -msgid "That means our `-1234567` is stored like this:" -msgstr "Это означает, что наш `-1234567` хранится следующим образом:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2731 -#, no-wrap -msgid "67 45 23 01 00 00 00 00 00 80\n" -msgstr "67 45 23 01 00 00 00 00 00 80\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2734 -msgid "Remember that, or you will be pulling your hair out in desperation!" -msgstr "Помните об этом, иначе вы будете рвать на себе волосы в отчаянии!" - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2740 -msgid "" -"The book to read-if you can find it-is Richard Startz' http://www.amazon.com/" -"exec/obidos/ASIN/013246604X/whizkidtechnomag[8087/80287/80387 for the IBM PC " -"& Compatibles]. Though it does seem to take the fact about the little-" -"endian storage of the _packed decimal_ for granted. I kid you not about the " -"desperation of trying to figure out what was wrong with the filter I show " -"below _before_ it occurred to me I should try the little-endian order even " -"for this type of data." -msgstr "" -"Книга, которую стоит прочитать — если сможете её найти — это книга Ричарда " -"Старца http://www.amazon.com/exec/obidos/ASIN/013246604X/" -"whizkidtechnomag[8087/80287/80387 для IBM PC и совместимых]. Хотя в ней, " -"кажется, факт о little-endian хранении _упакованного десятичного числа_ " -"принимается как данность. Я не шучу насчёт отчаяния, которое испытывал, " -"пытаясь понять, что не так с фильтром, который я привожу ниже, _прежде_ чем " -"мне пришло в голову попробовать little-endian порядок даже для этого типа " -"данных." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2743 -#, no-wrap -msgid "Excursion to Pinhole Photography" -msgstr "Экскурсия в фотографию с помощью камеры-обскуры" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2746 -msgid "" -"To write meaningful software, we must not only understand our programming " -"tools, but also the field we are creating software for." -msgstr "" -"Чтобы создавать полезное программное обеспечение, мы должны понимать не " -"только наши инструменты программирования, но и область, для которой " -"разрабатываем ПО." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2748 -msgid "" -"Our next filter will help us whenever we want to build a _pinhole camera_, " -"so, we need some background in _pinhole photography_ before we can continue." -msgstr "" -"Наш следующий фильтр поможет нам, когда мы захотим создать _камеру-обскуру_, " -"поэтому нам понадобятся некоторые знания о _фотографии с помощью обскуры_, " -"прежде чем мы сможем продолжить." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2750 -#, no-wrap -msgid "The Camera" -msgstr "Камера" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2753 -msgid "" -"The easiest way to describe any camera ever built is as some empty space " -"enclosed in some lightproof material, with a small hole in the enclosure." -msgstr "" -"Самый простой способ описать любую когда-либо созданную камеру — это " -"некоторое пустое пространство, заключённое в светонепроницаемый материал, с " -"небольшим отверстием в корпусе." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2758 -msgid "" -"The enclosure is usually sturdy (e.g., a box), though sometimes it is " -"flexible (the bellows). It is quite dark inside the camera. However, the " -"hole lets light rays in through a single point (though in some cases there " -"may be several). These light rays form an image, a representation of " -"whatever is outside the camera, in front of the hole." -msgstr "" -"Корпус обычно прочный (например, коробка), хотя иногда он гибкий " -"(гофрированная часть). Внутри камеры довольно темно. Однако отверстие " -"пропускает световые лучи через одну точку (хотя в некоторых случаях их может " -"быть несколько). Эти световые лучи формируют изображение — представление " -"того, что находится снаружи камеры, перед отверстием." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2760 -msgid "" -"If some light sensitive material (such as film) is placed inside the camera, " -"it can capture the image." -msgstr "" -"Если внутрь камеры поместить светочувствительный материал (например, " -"плёнку), он может зафиксировать изображение." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2762 -msgid "" -"The hole often contains a _lens_, or a lens assembly, often called the " -"_objective_." -msgstr "" -"Отверстие часто содержит _линзу_ или сборку линз, которую часто называют " -"_объективом_." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2764 -#, no-wrap -msgid "The Pinhole" -msgstr "Игольное ушко" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2768 -msgid "" -"But, strictly speaking, the lens is not necessary: The original cameras did " -"not use a lens but a _pinhole_. Even today, _pinholes_ are used, both as a " -"tool to study how cameras work, and to achieve a special kind of image." -msgstr "" -"Но, строго говоря, линза не обязательна: первые камеры использовали не " -"линзу, а _маленькое отверстие_ размером с игольное ушко. Даже сегодня " -"_маленькие отверстия_ применяются как инструмент для изучения принципов " -"работы камер и для создания особого вида изображений." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2772 -msgid "" -"The image produced by the _pinhole_ is all equally sharp. Or _blurred_. " -"There is an ideal size for a pinhole: If it is either larger or smaller, the " -"image loses its sharpness." -msgstr "" -"Изображение, создаваемое _маленьким отверстием_, одинаково резкое. Или " -"_размытое_. Существует идеальный размер для маленького отверстия: если оно " -"больше или меньше, изображение теряет резкость." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2774 -#, no-wrap -msgid "Focal Length" -msgstr "Фокусное расстояние" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2777 -msgid "" -"This ideal pinhole diameter is a function of the square root of _focal " -"length_, which is the distance of the pinhole from the film." -msgstr "" -"Идеальный диаметр отверстия является функцией квадратного корня из " -"_фокусного расстояния_, которое представляет собой расстояние от отверстия " -"до плёнки." - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2781 -#, no-wrap -msgid "D = PC * sqrt(FL)\n" -msgstr "D = PC * sqrt(FL)\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2787 -msgid "" -"In here, `D` is the ideal diameter of the pinhole, `FL` is the focal length, " -"and `PC` is a pinhole constant. According to Jay Bender, its value is " -"`0.04`, while Kenneth Connors has determined it to be `0.037`. Others have " -"proposed other values. Plus, this value is for the daylight only: Other " -"types of light will require a different constant, whose value can only be " -"determined by experimentation." -msgstr "" -"Здесь `D` — идеальный диаметр отверстия, `FL` — фокусное расстояние, а `PC` " -"— константа отверстия. По данным Джейя Бендера, её значение равно `0,04`, " -"тогда как Кеннет Коннорс определил его как `0,037`. Другие исследователи " -"предложили иные значения. Кроме того, это значение справедливо только для " -"дневного света: другие типы освещения потребуют иной константы, значение " -"которой можно определить только экспериментальным путём." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2789 -#, no-wrap -msgid "The F-Number" -msgstr "Число f (диафрагменное число)" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2793 -msgid "" -"The f-number is a very useful measure of how much light reaches the film. A " -"light meter can determine that, for example, to expose a film of specific " -"sensitivity with f/5.6 may require the exposure to last 1/1000 sec." -msgstr "" -"Число f — это очень полезный показатель того, сколько света попадает на " -"плёнку. Экспонометр может определить, что, например, для экспонирования " -"плёнки определённой чувствительности при f/5.6 может потребоваться выдержка " -"1/1000 сек." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2796 -msgid "" -"It does not matter whether it is a 35-mm camera, or a 6x9cm camera, etc. As " -"long as we know the f-number, we can determine the proper exposure." -msgstr "" -"Не имеет значения, 35-мм это камера или камера 6x9 см и т.д. Достаточно " -"знать диафрагменное число, чтобы определить правильную экспозицию." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2798 -msgid "The f-number is easy to calculate:" -msgstr "Число f легко вычислить:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2802 -#, no-wrap -msgid "F = FL / D\n" -msgstr "F = FL / D\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2807 -msgid "" -"In other words, the f-number equals the focal length divided by the diameter " -"of the pinhole. It also means a higher f-number either implies a smaller " -"pinhole or a larger focal distance, or both. That, in turn, implies, the " -"higher the f-number, the longer the exposure has to be." -msgstr "" -"Другими словами, число f равно фокусному расстоянию, деленному на диаметр " -"отверстия. Это также означает, что большее f-число подразумевает либо " -"меньшее отверстие, либо большее фокусное расстояние, либо и то, и другое. В " -"свою очередь, это означает, что чем больше число f, тем дольше должна быть " -"выдержка." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2810 -msgid "" -"Furthermore, while pinhole diameter and focal distance are one-dimensional " -"measurements, both, the film and the pinhole, are two-dimensional. That " -"means that if you have measured the exposure at f-number `A` as `t`, then " -"the exposure at f-number `B` is:" -msgstr "" -"Кроме того, хотя диаметр отверстия и фокусное расстояние являются " -"одномерными величинами, и плёнка, и отверстие — двумерны. Это означает, что " -"если вы измерили экспозицию при диафрагменном числе `A` как `t`, то " -"экспозиция при диафрагменном числе `B` будет:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2814 -#, no-wrap -msgid "t * (B / A)²\n" -msgstr "t * (B / A)²\n" - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2817 -#, no-wrap -msgid "Normalized F-Number" -msgstr "Нормализованное число f" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2820 -msgid "" -"While many modern cameras can change the diameter of their pinhole, and thus " -"their f-number, quite smoothly and gradually, such was not always the case." -msgstr "" -"Хотя многие современные камеры могут изменять диаметр своего отверстия, а " -"следовательно и свое число f, довольно плавно и постепенно, так было не " -"всегда." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2822 -msgid "" -"To allow for different f-numbers, cameras typically contained a metal plate " -"with several holes of different sizes drilled to them." -msgstr "" -"Для обеспечения различных значений диафрагмы в камерах обычно использовалась " -"металлическая пластина с несколькими отверстиями разного размера." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2825 -msgid "" -"Their sizes were chosen according to the above formula in such a way that " -"the resultant f-number was one of standard f-numbers used on all cameras " -"everywhere. For example, a very old Kodak Duaflex IV camera in my " -"possession has three such holes for f-numbers 8, 11, and 16." -msgstr "" -"Их размеры были выбраны в соответствии с приведённой выше формулой таким " -"образом, чтобы результирующее f-число было одним из стандартных f-чисел, " -"используемых на всех фотоаппаратах. Например, у моего очень старого " -"фотоаппарата Kodak Duaflex IV есть три таких отверстия для чисел f — 8, 11 и " -"16." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2828 -msgid "" -"A more recently made camera may offer f-numbers of 2.8, 4, 5.6, 8, 11, 16, " -"22, and 32 (as well as others). These numbers were not chosen arbitrarily: " -"They all are powers of the square root of 2, though they may be rounded " -"somewha." -msgstr "" -"Более современные камеры могут предлагать значения диафрагменного числа 2.8, " -"4, 5.6, 8, 11, 16, 22 и 32 (а также другие). Эти числа выбраны не " -"произвольно: все они являются степенями квадратного корня из 2, хотя могут " -"быть немного округлены." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2830 -#, no-wrap -msgid "The F-Stop" -msgstr "Ступени числа f" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2834 -msgid "" -"A typical camera is designed in such a way that setting any of the " -"normalized f-numbers changes the feel of the dial. It will naturally _stop_ " -"in that position. Because of that, these positions of the dial are called f-" -"stops." -msgstr "" -"Типичная камера устроена так, что установка любого из нормализованных чисел " -"f изменяет ощущение от регулятора. Он естественным образом _останавливается_ " -"в этом положении. Из-за этого такие положения регулятора называются f-" -"ступенями." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2838 -msgid "" -"Since the f-numbers at each stop are powers of the square root of 2, moving " -"the dial by 1 stop will double the amount of light required for proper " -"exposure. Moving it by 2 stops will quadruple the required exposure. " -"Moving the dial by 3 stops will require the increase in exposure 8 times, " -"etc." -msgstr "" -"Поскольку значения диафрагмы на каждой ступени являются степенями " -"квадратного корня из 2, поворот диска на 1 ступень удваивает количество " -"света, необходимое для правильной экспозиции. Поворот на 2 ступени " -"увеличивает требуемую экспозицию вчетверо. Поворот диска на 3 ступени " -"требует увеличения экспозиции в 8 раз и так далее." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2840 -#, no-wrap -msgid "Designing the Pinhole Software" -msgstr "Проектирование программного обеспечения камеры-обскуры" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2843 -msgid "" -"We are now ready to decide what exactly we want our pinhole software to do." -msgstr "" -"Мы готовы решить, что именно должно делать наше программное обеспечение для " -"камер-обскур." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2845 -#, no-wrap -msgid "Processing Program Input" -msgstr "Обработка ввода программы" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2849 -msgid "" -"Since its main purpose is to help us design a working pinhole camera, we " -"will use the _focal length_ as the input to the program. This is something " -"we can determine without software: Proper focal length is determined by the " -"size of the film and by the need to shoot \"regular\" pictures, wide angle " -"pictures, or telephoto pictures." -msgstr "" -"Поскольку основная цель — помочь нам разработать работающую камеру-обскуру, " -"мы будем использовать _фокусное расстояние_ в качестве входных данных для " -"программы. Это можно определить без программного обеспечения: правильное " -"фокусное расстояние зависит от размера плёнки и необходимости съёмки " -"«обычных» изображений, широкоугольных или телефото." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2851 -msgid "" -"Most of the programs we have written so far worked with individual " -"characters, or bytes, as their input: The hex program converted individual " -"bytes into a hexadecimal number, the csv program either let a character " -"through, or deleted it, or changed it to a different character, etc." -msgstr "" -"Большинство написанных нами до сих пор программ работали с отдельными " -"символами или байтами в качестве входных данных: программа hex " -"преобразовывала отдельные байты в шестнадцатеричное число, программа csv " -"либо пропускала символ, либо удаляла его, либо заменяла на другой символ и т." -"д." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2853 -msgid "" -"One program, ftuc used the state machine to consider at most two input bytes " -"at a time." -msgstr "" -"Одна программа, `ftuc`, использовала конечный автомат для обработки не более " -"двух входных байтов за раз." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2855 -msgid "" -"But our pinhole program cannot just work with individual characters, it has " -"to deal with larger syntactic units." -msgstr "" -"Но наша программа для камеры-обскуры не может работать только с отдельными " -"символами, ей приходится иметь дело с более крупными синтаксическими " -"единицами." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2857 -msgid "" -"For example, if we want the program to calculate the pinhole diameter (and " -"other values we will discuss later) at the focal lengths of `100 mm`, `150 " -"mm`, and `210 mm`, we may want to enter something like this:" -msgstr "" -"Например, если мы хотим, чтобы программа рассчитала диаметр отверстия (и " -"другие значения, которые мы обсудим позже) для фокусных расстояний `100 мм`, " -"`150 мм` и `210 мм`, мы можем ввести что-то вроде этого:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2861 -#, no-wrap -msgid " 100, 150, 210\n" -msgstr " 100, 150, 210\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2866 -msgid "" -"Our program needs to consider more than a single byte of input at a time. " -"When it sees the first `1`, it must understand it is seeing the first digit " -"of a decimal number. When it sees the `0` and the other `0`, it must know " -"it is seeing more digits of the same number." -msgstr "" -"Наша программа должна учитывать более одного байта входных данных за раз. " -"Когда она видит первую `1`, она должна понимать, что это первая цифра " -"десятичного числа. Когда она видит `0` и другой `0`, она должна знать, что " -"это следующие цифры того же числа." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2871 -msgid "" -"When it encounters the first comma, it must know it is no longer receiving " -"the digits of the first number. It must be able to convert the digits of " -"the first number into the value of `100`. And the digits of the second " -"number into the value of `150`. And, of course, the digits of the third " -"number into the numeric value of `210`." -msgstr "" -"Когда он встречает первую запятую, он должен понять, что больше не получает " -"цифры первого числа. Он должен уметь преобразовать цифры первого числа в " -"значение `100`. И цифры второго числа в значение `150`. И, конечно же, цифры " -"третьего числа в числовое значение `210`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2873 -msgid "" -"We need to decide what delimiters to accept: Do the input numbers have to be " -"separated by a comma? If so, how do we treat two numbers separated by " -"something else?" -msgstr "" -"Нам нужно определиться с допустимыми разделителями: должны ли входные числа " -"разделяться запятой? Если да, то как обрабатывать два числа, разделённые чем-" -"то другим?" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2878 -msgid "" -"Personally, I like to keep it simple. Something either is a number, so I " -"process it. Or it is not a number, so I discard it. I do not like the " -"computer complaining about me typing in an extra character when it is " -"_obvious_ that it is an extra character. Duh!" -msgstr "" -"Лично я предпочитаю простоту. Либо что-то является числом — и тогда я его " -"обрабатываю. Либо не является числом — и тогда я это отбрасываю. Мне не " -"нравится, когда компьютер жалуется на лишний символ, если _очевидно_, что он " -"лишний. Да ладно!" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2880 -msgid "" -"Plus, it allows me to break up the monotony of computing and type in a query " -"instead of just a number:" -msgstr "" -"Плюс, это позволяет мне разбавить монотонность вычислений и ввести запрос " -"вместо просто числа:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2885 -#, no-wrap -msgid "" -"What is the best pinhole diameter for the\n" -"\t focal length of 150?\n" -msgstr "" -"What is the best pinhole diameter for the\n" -"\t focal length of 150?\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2888 -msgid "There is no reason for the computer to spit out a number of complaints:" -msgstr "Нет причины, чтобы компьютер выводил множество жалоб:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2895 -#, no-wrap -msgid "" -"Syntax error: What\n" -"Syntax error: is\n" -"Syntax error: the\n" -"Syntax error: best\n" -msgstr "" -"Syntax error: What\n" -"Syntax error: is\n" -"Syntax error: the\n" -"Syntax error: best\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2898 -msgid "Et cetera, et cetera, et cetera." -msgstr "И так далее, и так далее, и так далее." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2901 -msgid "" -"Secondly, I like the `+#+` character to denote the start of a comment which " -"extends to the end of the line. This does not take too much effort to code, " -"and lets me treat input files for my software as executable scripts." -msgstr "" -"Во-вторых, мне нравится символ `+#+` для обозначения начала комментария, " -"который продолжается до конца строки. Это не требует больших усилий для " -"реализации и позволяет мне рассматривать входные файлы для моего " -"программного обеспечения как исполняемые скрипты." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2903 -msgid "" -"In our case, we also need to decide what units the input should come in: We " -"choose _millimeters_ because that is how most photographers measure the " -"focus length." -msgstr "" -"В нашем случае также необходимо определиться с единицами измерения входных " -"данных: мы выбираем _миллиметры_, так как большинство фотографов измеряют " -"фокусное расстояние именно в них." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2905 -msgid "" -"Finally, we need to decide whether to allow the use of the decimal point (in " -"which case we must also consider the fact that much of the world uses a " -"decimal _comma_)." -msgstr "" -"Наконец, нам нужно решить, разрешать ли использование десятичной точки (в " -"этом случае мы также должны учитывать тот факт, что во многих странах " -"используется десятичная _запятая_)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2909 -msgid "" -"In our case allowing for the decimal point/comma would offer a false sense " -"of precision: There is little if any noticeable difference between the focus " -"lengths of `50` and `51`, so allowing the user to input something like " -"`50.5` is not a good idea. This is my opinion, mind you, but I am the one " -"writing this program. You can make other choices in yours, of course." -msgstr "" -"В нашем случае разрешение десятичной точки/запятой создало бы ложное " -"ощущение точности: разница между фокусными расстояниями `50` и `51` " -"практически незаметна, поэтому разрешать пользователю вводить что-то вроде " -"`50.5` — не лучшая идея. Это моё мнение, конечно, но программу пишу я. В " -"своей программе вы можете сделать другие выбор, разумеется." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2911 -#, no-wrap -msgid "Offering Options" -msgstr "Передача параметров программе" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2916 -msgid "" -"The most important thing we need to know when building a pinhole camera is " -"the diameter of the pinhole. Since we want to shoot sharp images, we will " -"use the above formula to calculate the pinhole diameter from focal length. " -"As experts are offering several different values for the `PC` constant, we " -"will need to have the choice." -msgstr "" -"Самое важное, что нам нужно знать при создании камеры-обскуры — это диаметр " -"отверстия. Поскольку мы хотим получать чёткие изображения, мы будем " -"использовать приведённую выше формулу для расчёта диаметра отверстия от " -"фокусного расстояния. Поскольку эксперты предлагают несколько различных " -"значений для константы `PC`, нам нужно будет иметь выбор." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2918 -msgid "" -"It is traditional in UNIX(R) programming to have two main ways of choosing " -"program parameters, plus to have a default for the time the user does not " -"make a choice." -msgstr "" -"В традициях программирования в UNIX(R) предусмотрены два основных способа " -"выбора параметров программы, а также значение по умолчанию на случай, если " -"пользователь не сделает выбор." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2920 -msgid "Why have two ways of choosing?" -msgstr "Почему есть два способа выбора?" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2922 -msgid "" -"One is to allow a (relatively) _permanent_ choice that applies automatically " -"each time the software is run without us having to tell it over and over " -"what we want it to do." -msgstr "" -"Один из способов — это позволить (относительно) _постоянный_ выбор, который " -"применяется автоматически каждый раз при запуске программы, без " -"необходимости каждый раз указывать, что мы хотим, чтобы она сделала." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2927 -msgid "" -"The permanent choices may be stored in a configuration file, typically found " -"in the user's home directory. The file usually has the same name as the " -"application but is started with a dot. Often _\"rc\"_ is added to the file " -"name. So, ours could be [.filename]#~/.pinhole# or [.filename]#~/." -"pinholerc#. (The [.filename]#~/# means current user's home directory.)" -msgstr "" -"Постоянные настройки могут быть сохранены в конфигурационном файле, обычно " -"расположенном в домашнем каталоге пользователя. Файл обычно имеет то же имя, " -"что и приложение, но начинается с точки. Часто к имени файла добавляется _" -"\"rc\"_. Таким образом, наш файл может называться [.filename]#~/.pinhole# " -"или [.filename]#~/.pinholerc#. (Обозначение [.filename]#~/# означает " -"домашний каталог текущего пользователя.)" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2932 -msgid "" -"The configuration file is used mostly by programs that have many " -"configurable parameters. Those that have only one (or a few) often use a " -"different method: They expect to find the parameter in an _environment " -"variable_. In our case, we might look at an environment variable named " -"`PINHOLE`." -msgstr "" -"Файл конфигурации в основном используется программами, у которых много " -"настраиваемых параметров. Те, у которых он один (или несколько), часто " -"используют другой метод: они ожидают найти параметр в _переменной " -"окружения_. В нашем случае, мы можем посмотреть на переменную окружения с " -"именем `PINHOLE`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2935 -msgid "" -"Usually, a program uses one or the other of the above methods. Otherwise, " -"if a configuration file said one thing, but an environment variable another, " -"the program might get confused (or just too complicated)." -msgstr "" -"Обычно программа использует один из вышеуказанных методов. В противном " -"случае, если в конфигурационном файле указано одно, а в переменной окружения " -"— другое, программа может запутаться (или стать слишком сложной)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2937 -msgid "" -"Because we only need to choose _one_ such parameter, we will go with the " -"second method and search the environment for a variable named `PINHOLE`." -msgstr "" -"Поскольку нам нужно выбрать только _один_ такой параметр, мы воспользуемся " -"вторым методом и поищем в окружении переменную с именем `PINHOLE`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2940 -msgid "" -"The other way allows us to make _ad hoc_ decisions: _\"Though I usually want " -"you to use 0.039, this time I want 0.03872.\"_ In other words, it allows us " -"to _override_ the permanent choice." -msgstr "" -"Другой способ позволяет нам принимать _ad hoc_ решения: _\"Хотя обычно я " -"хочу, чтобы ты использовал 0.039, на этот раз мне нужно 0.03872.\"_ Другими " -"словами, он позволяет нам _переопределить_ постоянный выбор." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2942 -msgid "This type of choice is usually done with command line parameters." -msgstr "" -"Такой выбор обычно осуществляется с помощью параметров командной строки." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2950 -msgid "" -"Finally, a program _always_ needs a _default_. The user may not make any " -"choices. Perhaps he does not know what to choose. Perhaps he is \"just " -"browsing.\" Preferably, the default will be the value most users would " -"choose anyway. That way they do not need to choose. Or, rather, they can " -"choose the default without an additional effort." -msgstr "" -"Наконец, программе _всегда_ необходим _значение по умолчанию_. Пользователь " -"может не делать никакого выбора. Возможно, он не знает, что выбрать. " -"Возможно, он «просто просматривает». Предпочтительно, чтобы значением по " -"умолчанию было то, что выбрало бы большинство пользователей. Таким образом, " -"им не нужно выбирать. Или, точнее, они могут выбрать значение по умолчанию " -"без дополнительных усилий." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2952 -msgid "" -"Given this system, the program may find conflicting options, and handle them " -"this way:" -msgstr "" -"Учитывая эту систему, программа может обнаружить конфликтующие параметры и " -"обработать их следующим образом:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2955 -msgid "" -"If it finds an _ad hoc_ choice (e.g., command line parameter), it should " -"accept that choice. It must ignore any permanent choice and any default." -msgstr "" -"Если она находит _специальный_ выбор (например, параметр командной строки), " -"она должна принять этот выбор. Она должна игнорировать любой постоянный " -"выбор и значения по умолчанию." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2956 -msgid "" -"_Otherwise_, if it finds a permanent option (e.g., an environment variable), " -"it should accept it, and ignore the default." -msgstr "" -"_В противном случае_, если будет найден постоянный параметр (например, " -"переменная окружения), он должен быть принят, а значение по умолчанию — " -"проигнорировано." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2957 -msgid "_Otherwise_, it should use the default." -msgstr "_В противном случае_, следует использовать значение по умолчанию." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2959 -msgid "We also need to decide what _format_ our `PC` option should have." -msgstr "" -"Нам также необходимо решить, в каком _формате_ должна быть наша опция `PC`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2961 -msgid "" -"At first site, it seems obvious to use the `PINHOLE=0.04` format for the " -"environment variable, and `-p0.04` for the command line." -msgstr "" -"На первый взгляд кажется очевидным использовать формат `PINHOLE=0.04` для " -"переменной окружения и `-p0.04` для командной строки." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2965 -msgid "" -"Allowing that is actually a security risk. The `PC` constant is a very small " -"number. Naturally, we will test our software using various small values of " -"`PC`. But what will happen if someone runs the program choosing a huge " -"value?" -msgstr "" -"Разрешение этого на самом деле представляет угрозу безопасности. Константа " -"`PC` — это очень маленькое число. Естественно, мы протестируем наше " -"программное обеспечение, используя различные небольшие значения `PC`. Но что " -"произойдёт, если кто-то запустит программу, выбрав огромное значение?" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2967 -msgid "" -"It may crash the program because we have not designed it to handle huge " -"numbers." -msgstr "" -"Это может привести к сбою программы, так как мы не разрабатывали её для " -"обработки огромных чисел." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2970 -msgid "" -"Or, we may spend more time on the program so it can handle huge numbers. We " -"might do that if we were writing commercial software for computer illiterate " -"audience." -msgstr "" -"Или мы можем потратить больше времени на программу, чтобы она могла " -"обрабатывать огромные числа. Мы могли бы сделать это, если бы писали " -"коммерческое программное обеспечение для аудитории, не знакомой с " -"компьютерами." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2972 -msgid "Or, we might say, _\"Tough! The user should know better.\"\"_" -msgstr "" -"Или можно сказать: _\"Пусть терпит! Пользователь сам должен был разобраться." -"\"_" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2975 -msgid "" -"Or, we just may make it impossible for the user to enter a huge number. " -"This is the approach we will take: We will use an _implied 0._ prefix." -msgstr "" -"Или мы можем просто сделать невозможным ввод пользователем слишком большого " -"числа. Это подход, который мы выберем: мы будем использовать " -"_подразумеваемый префикс 0._." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2978 -msgid "" -"In other words, if the user wants `0.04`, we will expect him to type `-p04`, " -"or set `PINHOLE=04` in his environment. So, if he says `-p9999999`, we will " -"interpret it as ``0.9999999``-still ridiculous but at least safer." -msgstr "" -"Другими словами, если пользователь хочет `0.04`, мы ожидаем, что он введёт `-" -"p04` или установит `PINHOLE=04` в своём окружении. Таким образом, если он " -"укажет `-p9999999`, мы интерпретируем это как ``0.9999999`` — всё ещё " -"нелепо, но по крайней мере безопаснее." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2981 -msgid "" -"Secondly, many users will just want to go with either Bender's constant or " -"Connors' constant. To make it easier on them, we will interpret `-b` as " -"identical to `-p04`, and `-c` as identical to `-p037`." -msgstr "" -"Во-вторых, многие пользователи просто захотят использовать либо константу " -"Бендера, либо константу Коннорса. Чтобы облегчить им задачу, мы будем " -"интерпретировать `-b` как идентичное `-p04`, а `-c` как идентичное `-p037`." - -#. type: Title ==== -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2983 -#, no-wrap -msgid "The Output" -msgstr "Вывод результата" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2986 -msgid "" -"We need to decide what we want our software to send to the output, and in " -"what format." -msgstr "" -"Нам нужно решить, что наше программное обеспечение должно отправлять на " -"вывод и в каком формате." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2988 -msgid "" -"Since our input allows for an unspecified number of focal length entries, it " -"makes sense to use a traditional database-style output of showing the result " -"of the calculation for each focal length on a separate line, while " -"separating all values on one line by a `tab` character." -msgstr "" -"Поскольку наши входные данные допускают неограниченное количество значений " -"фокусного расстояния, имеет смысл использовать традиционный вывод в стиле " -"базы данных, показывая результат вычислений для каждого фокусного расстояния " -"на отдельной строке, разделяя все значения в строке символом табуляции." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2991 -msgid "" -"Optionally, we should also allow the user to specify the use of the CSV " -"format we have studied earlier. In this case, we will print out a line of " -"comma-separated names describing each field of every line, then show our " -"results as before, but substituting a `comma` for the `tab`." -msgstr "" -"Опционально, мы также должны разрешить пользователю указать использование " -"формата CSV, который мы изучили ранее. В этом случае мы выведем строку с " -"разделёнными запятыми названиями, описывающими каждое поле каждой строки, а " -"затем отобразим результаты как прежде, но заменив `табуляцию` на `запятую`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:2996 -msgid "" -"We need a command line option for the CSV format. We cannot use `-c` " -"because that already means _use Connors' constant_. For some strange " -"reason, many web sites refer to CSV files as _\"Excel spreadsheet\"_ (though " -"the CSV format predates Excel). We will, therefore, use the `-e` switch to " -"inform our software we want the output in the CSV format." -msgstr "" -"Нам нужна опция командной строки для формата CSV. Мы не можем использовать `-" -"c`, потому что это уже означает _использовать константу Коннорса_. По какой-" -"то странной причине многие веб-сайты называют CSV-файлы _\"электронными " -"таблицами Excel\"_ (хотя формат CSV появился раньше Excel). Поэтому мы будем " -"использовать переключатель `-e`, чтобы указать нашему программному " -"обеспечению, что мы хотим получить вывод в формате CSV." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3000 -msgid "" -"We will start each line of the output with the focal length. This may sound " -"repetitious at first, especially in the interactive mode: The user types in " -"the focal length, and we are repeating it." -msgstr "" -"Мы начнем каждую строку вывода с фокусного расстояния. Это может показаться " -"избыточным сначала, особенно в интерактивном режиме: пользователь вводит " -"фокусное расстояние, а мы его повторяем." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3004 -msgid "" -"But the user can type several focal lengths on one line. The input can also " -"come in from a file or from the output of another program. In that case the " -"user does not see the input at all." -msgstr "" -"Но пользователь может ввести несколько фокусных расстояний в одной строке. " -"Ввод также может поступать из файла или вывода другой программы. В этом " -"случае пользователь вообще не видит вводимые данные." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3006 -msgid "" -"By the same token, the output can go to a file which we will want to examine " -"later, or it could go to the printer, or become the input of another program." -msgstr "" -"Таким же образом, вывод может быть направлен в файл, который мы захотим " -"изучить позже, или на принтер, или стать входными данными для другой " -"программы." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3008 -msgid "" -"So, it makes perfect sense to start each line with the focal length as " -"entered by the user." -msgstr "" -"Итак, имеет полный смысл начинать каждую строку с фокусного расстояния, " -"введённого пользователем." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3011 -msgid "" -"No, wait! Not as entered by the user. What if the user types in something " -"like this:" -msgstr "" -"Нет, подождите! Не так, как ввел пользователь. Что, если пользователь " -"введет что-то вроде этого:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3015 -#, no-wrap -msgid " 00000000150\n" -msgstr " 00000000150\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3018 -msgid "Clearly, we need to strip those leading zeros." -msgstr "Очевидно, нам нужно удалить ведущие нули." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3020 -msgid "" -"So, we might consider reading the user input as is, converting it to binary " -"inside the FPU, and printing it out from there." -msgstr "" -"Итак, можно рассмотреть вариант чтения пользовательского ввода как есть, " -"преобразования его в бинарный вид внутри FPU и последующего вывода оттуда." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3022 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3207 -msgid "But..." -msgstr "Но..." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3024 -msgid "What if the user types something like this:" -msgstr "Что делать, если пользователь введёт что-то вроде этого:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3028 -#, no-wrap -msgid " 17459765723452353453534535353530530534563507309676764423\n" -msgstr " 17459765723452353453534535353530530534563507309676764423\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3033 -msgid "" -"Ha! The packed decimal FPU format lets us input 18-digit numbers. But the " -"user has entered more than 18 digits. How do we handle that?" -msgstr "" -"Ха! Упакованный десятичный формат FPU позволяет нам вводить 18-значные " -"числа. Но пользователь ввёл больше 18 цифр. Как нам обработать это?" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3035 -msgid "" -"Well, we _could_ modify our code to read the first 18 digits, enter it to " -"the FPU, then read more, multiply what we already have on the TOS by 10 " -"raised to the number of additional digits, then `add` to it." -msgstr "" -"Хорошо, мы _могли бы_ изменить наш код, чтобы он читал первые 18 цифр, " -"передавал их в FPU, затем читал ещё, умножал уже имеющееся на вершине стека " -"(TOS) на 10 в степени количества дополнительных цифр, а затем выполнял " -"`сложение` с этим значением." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3039 -msgid "" -"Yes, we could do that. But in _this_ program it would be ridiculous (in a " -"different one it may be just the thing to do): Even the circumference of the " -"Earth expressed in millimeters only takes 11 digits. Clearly, we cannot " -"build a camera that large (not yet, anyway)." -msgstr "" -"Да, мы могли бы так поступить. Но в _этой_ программе это было бы нелепо (в " -"другой это могло бы быть как раз тем, что нужно): даже длина окружности " -"Земли, выраженная в миллиметрах, занимает всего 11 цифр. Очевидно, мы не " -"можем построить камеру такого размера (по крайней мере, пока)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3041 -msgid "" -"So, if the user enters such a huge number, he is either bored, or testing " -"us, or trying to break into the system, or playing games-doing anything but " -"designing a pinhole camera." -msgstr "" -"Итак, если пользователь вводит такое огромное число, он либо скучает, либо " -"проверяет нас, либо пытается взломать систему, либо играет — делает что " -"угодно, кроме проектирования камеры-обскуры." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3043 -msgid "What will we do?" -msgstr "Что мы будем делать?" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3045 -msgid "We will slap him in the face, in a manner of speaking:" -msgstr "Мы ударим его по лицу, образно говоря:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3049 -#, no-wrap -msgid "17459765723452353453534535353530530534563507309676764423\t???\t???\t???\t???\t???\n" -msgstr "17459765723452353453534535353530530534563507309676764423\t???\t???\t???\t???\t???\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3053 -msgid "" -"To achieve that, we will simply ignore any leading zeros. Once we find a " -"non-zero digit, we will initialize a counter to `0` and start taking three " -"steps:" -msgstr "" -"Для этого мы просто проигнорируем все ведущие нули. Как только мы найдем " -"ненулевую цифру, мы инициализируем счетчик значением `0` и начнем выполнять " -"три шага:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3056 -msgid "Send the digit to the output." -msgstr "Отправить цифру на выход." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3057 -msgid "" -"Append the digit to a buffer we will use later to produce the packed decimal " -"we can send to the FPU." -msgstr "" -"Добавить цифру в буфер, который мы позже используем для создания " -"упакованного десятичного числа, которое можно отправить в FPU." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3058 -msgid "Increase the counter." -msgstr "Увеличить счетчик." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3060 -msgid "" -"Now, while we are taking these three steps, we also need to watch out for " -"one of two conditions:" -msgstr "" -"Теперь, пока мы выполняем эти три шага, нам также необходимо следить за " -"одним из двух условий:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3062 -msgid "" -"If the counter grows above 18, we stop appending to the buffer. We continue " -"reading the digits and sending them to the output." -msgstr "" -"Если счётчик превышает 18, мы прекращаем добавление в буфер. Мы продолжаем " -"читать цифры и отправлять их на вывод." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3063 -msgid "" -"If, or rather _when_, the next input character is not a digit, we are done " -"inputting for now." -msgstr "" -"Если, или скорее _когда_, следующий вводимый символ не является цифрой, мы " -"завершаем ввод на данный момент." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3066 -msgid "" -"Incidentally, we can simply discard the non-digit, unless it is a `+#+`, " -"which we must return to the input stream. It starts a comment, so we must " -"see it after we are done producing output and start looking for more input." -msgstr "" -"Между прочим, мы можем просто отбросить нецифровой символ, если это не `+#" -"+`, который необходимо вернуть во входной поток. Он начинает комментарий, " -"поэтому мы должны увидеть его после завершения вывода и начала поиска " -"следующего ввода." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3068 -msgid "" -"That still leaves one possibility uncovered: If all the user enters is a " -"zero (or several zeros), we will never find a non-zero to display." -msgstr "" -"Остается одна непокрытая возможность: если пользователь вводит только ноль " -"(или несколько нулей), мы никогда не найдем ненулевое значение для " -"отображения." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3071 -msgid "" -"We can determine this has happened whenever our counter stays at `0`. In " -"that case we need to send `0` to the output, and perform another \"slap in " -"the face\":" -msgstr "" -"Мы можем определить, что это произошло, когда наш счетчик остаётся на `0`. В " -"этом случае нам нужно отправить `0` на выход и выполнить ещё один \"удар по " -"лицу\":" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3075 -#, no-wrap -msgid "0\t???\t???\t???\t???\t???\n" -msgstr "0\t???\t???\t???\t???\t???\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3078 -msgid "" -"Once we have displayed the focal length and determined it is valid (greater " -"than `0` but not exceeding 18 digits), we can calculate the pinhole diameter." -msgstr "" -"Как только мы определили фокусное расстояние и убедились, что оно корректно " -"(больше `0`, но не превышает 18 цифр), можно рассчитать диаметр отверстия." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3081 -msgid "" -"It is not by coincidence that _pinhole_ contains the word _pin_. Indeed, " -"many a pinhole literally is a _pin hole_, a hole carefully punched with the " -"tip of a pin." -msgstr "" -"Не случайно слово _булавочное ушко_ содержит слово _булавка_. Действительно, " -"многие малые отверстия буквально являются _дырками от булавки_ — " -"отверстиями, аккуратно проделанными остриём булавки." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3084 -msgid "" -"That is because a typical pinhole is very small. Our formula gets the result " -"in millimeters. We will multiply it by `1000`, so we can output the result " -"in _microns_." -msgstr "" -"Вот потому что типичное отверстие очень маленькое. Наша формула даёт " -"результат в миллиметрах. Мы умножим его на `1000`, чтобы вывести результат в " -"_микронах_." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3086 -msgid "At this point we have yet another trap to face: _Too much precision._" -msgstr "На этом этапе нас ожидает ещё одна ловушка: _Излишняя точность._" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3090 -msgid "" -"Yes, the FPU was designed for high precision mathematics. But we are not " -"dealing with high precision mathematics. We are dealing with physics " -"(optics, specifically)." -msgstr "" -"Да, FPU был разработан для вычислений с высокой точностью. Но мы имеем дело " -"не с вычислениями высокой точности. Мы имеем дело с физикой (конкретно, с " -"оптикой)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3094 -msgid "" -"Suppose we want to convert a truck into a pinhole camera (we would not be " -"the first ones to do that!). Suppose its box is `12` meters long, so we " -"have the focal length of `12000`. Well, using Bender's constant, it gives " -"us square root of `12000` multiplied by `0.04`, which is `4.381780460` " -"millimeters, or `4381.780460` microns." -msgstr "" -"Предположим, мы хотим превратить грузовик в камеру-обскуру (мы будем не " -"первыми, кто это сделал!). Допустим, его кузов имеет длину `12` метров, " -"значит, фокусное расстояние равно `12000`. Используя константу Бендера, " -"получаем квадратный корень из `12000`, умноженный на `0.04`, что составляет " -"`4.381780460` миллиметра или `4381.780460` микрона." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3099 -msgid "" -"Put either way, the result is absurdly precise. Our truck is not _exactly_ " -"`12000` millimeters long. We did not measure its length with such a " -"precision, so stating we need a pinhole with the diameter of `4.381780460` " -"millimeters is, well, deceiving. `4.4` millimeters would do just fine." -msgstr "" -"Как ни посмотри, результат абсурдно точен. Наш грузовик не имеет _точно_ " -"`12000` миллиметров в длину. Мы не измеряли его длину с такой точностью, " -"поэтому утверждение, что нам нужна отверстие диаметром `4,381780460` " -"миллиметра, мягко говоря, вводит в заблуждение. `4,4` миллиметра будет " -"вполне достаточно." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3104 -msgid "" -"I \"only\" used ten digits in the above example. Imagine the absurdity of " -"going for all 18!" -msgstr "" -"Я \"всего лишь\" использовал десять цифр в приведённом выше примере. " -"Представьте абсурдность попытки использовать все 18!" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3110 -msgid "" -"We need to limit the number of significant digits of our result. One way of " -"doing it is by using an integer representing microns. So, our truck would " -"need a pinhole with the diameter of `4382` microns. Looking at that number, " -"we still decide that `4400` microns, or `4.4` millimeters is close enough." -msgstr "" -"Нам нужно ограничить количество значащих цифр в нашем результате. Один из " -"способов сделать это — использовать целое число, представляющее микроны. " -"Таким образом, нашему грузовику потребуется отверстие диаметром `4382` " -"микрона. Глядя на это число, мы всё же решаем, что `4400` микрон, или `4.4` " -"миллиметра, достаточно близко." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3113 -msgid "" -"Additionally, we can decide that no matter how big a result we get, we only " -"want to display four significant digits (or any other number of them, of " -"course). Alas, the FPU does not offer rounding to a specific number of " -"digits (after all, it does not view the numbers as decimal but as binary)." -msgstr "" -"Кроме того, мы можем решить, что независимо от размера результата, мы хотим " -"отображать только четыре значащих цифры (или любое другое их количество, " -"конечно). Увы, FPU не поддерживает округление до определённого количества " -"цифр (в конце концов, он воспринимает числа не как десятичные, а как " -"двоичные)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3115 -msgid "" -"We, therefore, must devise an algorithm to reduce the number of significant " -"digits." -msgstr "" -"Следовательно, мы должны разработать алгоритм для уменьшения количества " -"значащих цифр." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3117 -msgid "" -"Here is mine (I think it is awkward-if you know a better one, _please_, let " -"me know):" -msgstr "" -"Вот мой (я думаю, он неуклюжий — если у вас есть вариант лучше, " -"_пожалуйста_, дайте мне знать):" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3120 -msgid "Initialize a counter to `0`." -msgstr "Инициализировать счетчик значением `0`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3121 -msgid "" -"While the number is greater than or equal to `10000`, divide it by `10` and " -"increase the counter." -msgstr "" -"Пока число больше или равно `10000`, делим его на `10` и увеличиваем счётчик." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3122 -msgid "Output the result." -msgstr "Вывести результат." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3123 -msgid "" -"While the counter is greater than `0`, output `0` and decrease the counter." -msgstr "Пока счетчик больше `0`, выводить `0` и уменьшать счетчик." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3128 -msgid "" -"The `10000` is only good if you want _four_ significant digits. For any " -"other number of significant digits, replace `10000` with `10` raised to the " -"number of significant digits." -msgstr "" -"`10000` подходит только если вам нужно _четыре_ значащих цифры. Для любого " -"другого количества значащих цифр замените `10000` на `10` в степени, равной " -"количеству значащих цифр." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3131 -msgid "" -"We will, then, output the pinhole diameter in microns, rounded off to four " -"significant digits." -msgstr "" -"Мы затем выведем диаметр отверстия в микронах, округлённый до четырёх " -"значащих цифр." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3134 -msgid "" -"At this point, we know the _focal length_ and the _pinhole diameter_. That " -"means we have enough information to also calculate the _f-number_." -msgstr "" -"На этом этапе нам известны _фокусное расстояние_ и _диаметр отверстия_. Это " -"означает, что у нас достаточно информации для расчёта _диафрагменного числа_." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3138 -msgid "" -"We will display the f-number, rounded to four significant digits. Chances " -"are the f-number will tell us very little. To make it more meaningful, we " -"can find the nearest _normalized f-number_, i.e., the nearest power of the " -"square root of 2." -msgstr "" -"Мы отобразим число f, округлённое до четырёх значащих цифр. Скорее всего, " -"само число f мало что нам скажет. Чтобы придать ему больше смысла, мы можем " -"найти ближайшее _нормализованное число f_, то есть ближайшую степень " -"квадратного корня из 2." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3144 -msgid "" -"We do that by multiplying the actual f-number by itself, which, of course, " -"will give us its `square`. We will then calculate its base-2 logarithm, " -"which is much easier to do than calculating the base-square-root-of-2 " -"logarithm! We will round the result to the nearest integer. Next, we will " -"raise 2 to the result. Actually, the FPU gives us a good shortcut to do " -"that: We can use the `fscale` op code to \"scale\" 1, which is analogous to " -"``shift``ing an integer left. Finally, we calculate the square root of it " -"all, and we have the nearest normalized f-number." -msgstr "" -"Мы делаем это, умножая фактическое значение диафрагмы на само себя, что, " -"конечно же, даст нам его `квадрат`. Затем мы вычислим его логарифм по " -"основанию 2, что намного проще, чем вычисление логарифма по основанию " -"квадратного корня из 2! Мы округлим результат до ближайшего целого числа. " -"Далее мы возведём 2 в полученную степень. На самом деле, FPU предоставляет " -"нам удобный способ сделать это: мы можем использовать код операции `fscale` " -"для \"масштабирования\" 1, что аналогично ``сдвигу`` целого числа влево. " -"Наконец, мы вычисляем квадратный корень из всего этого и получаем ближайшее " -"нормализованное значение диафрагмы." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3147 -msgid "" -"If all that sounds overwhelming-or too much work, perhaps-it may become much " -"clearer if you see the code. It takes 9 op codes altogether:" -msgstr "" -"Если всё это звучит ошеломляюще — или, возможно, слишком сложно — всё может " -"стать гораздо понятнее, если увидеть код. Вместе это занимает всего 9 " -"инструкций процессора:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3159 -#, no-wrap -msgid "" -"fmul\tst0, st0\n" -"\tfld1\n" -"\tfld\tst1\n" -"\tfyl2x\n" -"\tfrndint\n" -"\tfld1\n" -"\tfscale\n" -"\tfsqrt\n" -"\tfstp\tst1\n" -msgstr "" -"fmul\tst0, st0\n" -"\tfld1\n" -"\tfld\tst1\n" -"\tfyl2x\n" -"\tfrndint\n" -"\tfld1\n" -"\tfscale\n" -"\tfsqrt\n" -"\tfstp\tst1\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3163 -msgid "" -"The first line, `fmul st0, st0`, squares the contents of the TOS (top of the " -"stack, same as `st`, called `st0` by nasm). The `fld1` pushes `1` on the " -"TOS." -msgstr "" -"Первая строка, `fmul st0, st0`, возводит в квадрат содержимое TOS (вершина " -"стека, то же что `st`, называется `st0` в nasm). Команда `fld1` помещает `1` " -"на вершину стека." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3167 -msgid "" -"The next line, `fld st1`, pushes the square back to the TOS. At this point " -"the square is both in `st` and `st(2)` (it will become clear why we leave a " -"second copy on the stack in a moment). `st(1)` contains `1`." -msgstr "" -"Следующая строка, `fld st1`, помещает квадрат обратно в TOS. На этом этапе " -"квадрат находится и в `st`, и в `st(2)` (скоро станет ясно, зачем мы " -"оставляем вторую копию в стеке). В `st(1)` содержится `1`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3170 -msgid "" -"Next, `fyl2x` calculates base-2 logarithm of `st` multiplied by `st(1)`. " -"That is why we placed `1` on `st(1)` before." -msgstr "" -"Далее, `fyl2x` вычисляет логарифм по основанию 2 от `st`, умноженный на " -"`st(1)`. Именно поэтому мы ранее поместили `1` в `st(1)`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3172 -msgid "" -"At this point, `st` contains the logarithm we have just calculated, `st(1)` " -"contains the square of the actual f-number we saved for later." -msgstr "" -"На этом этапе `st` содержит логарифм, который мы только что вычислили, а " -"`st(1)` содержит квадрат фактического значения диафрагменного числа, который " -"мы сохранили для последующего использования." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3176 -msgid "" -"`frndint` rounds the TOS to the nearest integer. `fld1` pushes a `1`. " -"`fscale` shifts the `1` we have on the TOS by the value in `st(1)`, " -"effectively raising 2 to `st(1)`." -msgstr "" -"`frndint` округляет TOS до ближайшего целого числа. `fld1` помещает `1` в " -"стек. `fscale` сдвигает `1`, находящееся на TOS, на значение в `st(1)`, " -"фактически возводя 2 в степень `st(1)`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3178 -msgid "" -"Finally, `fsqrt` calculates the square root of the result, i.e., the nearest " -"normalized f-number." -msgstr "" -"Наконец, `fsqrt` вычисляет квадратный корень из результата, т.е. ближайшее " -"нормализованное число f." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3181 -msgid "" -"We now have the nearest normalized f-number on the TOS, the base-2 logarithm " -"rounded to the nearest integer in `st(1)`, and the square of the actual f-" -"number in `st(2)`. We are saving the value in `st(2)` for later." -msgstr "" -"У нас теперь есть ближайшее нормализованное число f на вершине стека (TOS), " -"округлённый до ближайшего целого двоичный логарифм в `st(1)` и квадрат " -"фактического число f в `st(2)`. Мы сохраняем значение в `st(2)` для " -"последующего использования." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3187 -msgid "" -"But we do not need the contents of `st(1)` anymore. The last line, `fstp " -"st1`, places the contents of `st` to `st(1)`, and pops. As a result, what " -"was `st(1)` is now `st`, what was `st(2)` is now `st(1)`, etc. The new `st` " -"contains the normalized f-number. The new `st(1)` contains the square of " -"the actual f-number we have stored there for posterity." -msgstr "" -"Но нам больше не нужно содержимое `st(1)`. Последняя строка, `fstp st1`, " -"помещает содержимое `st` в `st(1)` и выполняет извлечение. В результате, то, " -"что было `st(1)`, теперь становится `st`, то, что было `st(2)`, теперь " -"становится `st(1)`, и так далее. Новый `st` содержит нормализованное число " -"f. Новый `st(1)` содержит квадрат фактического число f, который мы сохранили " -"для потомков." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3190 -msgid "" -"At this point, we are ready to output the normalized f-number. Because it " -"is normalized, we will not round it off to four significant digits, but will " -"send it out in its full precision." -msgstr "" -"На этом этапе мы готовы вывести нормализованное число f. Поскольку оно " -"нормализовано, мы не будем округлять его до четырёх значащих цифр, а " -"отправим его с полной точностью." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3193 -msgid "" -"The normalized f-number is useful as long as it is reasonably small and can " -"be found on our light meter. Otherwise we need a different method of " -"determining proper exposure." -msgstr "" -"Нормализованное диафрагменное число полезно, пока оно достаточно мало и " -"может быть найдено на нашем экспонометре. В противном случае нам нужен " -"другой метод определения правильной экспозиции." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3195 -msgid "" -"Earlier we have figured out the formula of calculating proper exposure at an " -"arbitrary f-number from that measured at a different f-number." -msgstr "" -"Ранее мы вывели формулу для расчёта правильной экспозиции при произвольной " -"диафрагме на основе измерений, сделанных при другой диафрагме." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3198 -msgid "" -"Every light meter I have ever seen can determine proper exposure at f5.6. " -"We will, therefore, calculate an _\"f5.6 multiplier,\"_ i.e., by how much we " -"need to multiply the exposure measured at f5.6 to determine the proper " -"exposure for our pinhole camera." -msgstr "" -"Каждый экспонометр, который я когда-либо видел, может определить правильную " -"экспозицию при f5.6. Поэтому мы рассчитаем _\"множитель f5.6\"_, то есть " -"насколько нужно умножить экспозицию, измеренную при f5.6, чтобы определить " -"правильную экспозицию для нашей камеры-обскуры." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3200 -msgid "" -"From the above formula we know this factor can be calculated by dividing our " -"f-number (the actual one, not the normalized one) by `5.6`, and squaring the " -"result." -msgstr "" -"Из приведённой формулы мы знаем, что этот коэффициент можно вычислить, " -"разделив наше число f (фактическое, а не нормализованное) на `5.6` и возведя " -"результат в квадрат." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3202 -msgid "" -"Mathematically, dividing the square of our f-number by the square of `5.6` " -"will give us the same result." -msgstr "" -"Математически, деление квадрата нашего числа f на квадрат `5.6` даст нам тот " -"же результат." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3205 -msgid "" -"Computationally, we do not want to square two numbers when we can only " -"square one. So, the first solution seems better at first." -msgstr "" -"С вычислительной точки зрения, нам не нужно возводить в квадрат два числа, " -"когда можно возвести только одно. Таким образом, первое решение на первый " -"взгляд кажется лучше." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3213 -msgid "" -"`5.6` is a _constant_. We do not have to have our FPU waste precious " -"cycles. We can just tell it to divide the square of the f-number by " -"whatever `5.6²` equals to. Or we can divide the f-number by `5.6`, and then " -"square the result. The two ways now seem equal." -msgstr "" -"`5.6` — это _константа_. Нам не нужно заставлять наш FPU тратить драгоценные " -"циклы. Мы можем просто указать ему разделить квадрат f-числа на то, чему " -"равно `5.6²`. Или мы можем разделить f-число на `5.6`, а затем возвести " -"результат в квадрат. Теперь оба способа кажутся равнозначными." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3215 -msgid "But, they are not!" -msgstr "Но они не такие!" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3219 -msgid "" -"Having studied the principles of photography above, we remember that the " -"`5.6` is actually square root of 2 raised to the fifth power. An " -"_irrational_ number. The square of this number is _exactly_ `32`." -msgstr "" -"Изучив принципы фотографии выше, мы помним, что `5.6` — это квадратный " -"корень из 2, возведённый в пятую степень. Это _иррациональное_ число. " -"Квадрат этого числа _ровно_ `32`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3225 -msgid "" -"Not only is `32` an integer, it is a power of 2. We do not need to divide " -"the square of the f-number by `32`. We only need to use `fscale` to shift " -"it right by five positions. In the FPU lingo it means we will `fscale` it " -"with `st(1)` equal to `-5`. That is _much faster_ than a division." -msgstr "" -"`32` — это не просто целое число, это степень двойки. Нам не нужно делить " -"квадрат числа f на `32`. Достаточно использовать `fscale` для сдвига вправо " -"на пять позиций. В терминологии FPU это означает, что мы применим `fscale` " -"со значением `st(1)` равным `-5`. Это _гораздо быстрее_, чем деление." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3228 -msgid "" -"So, now it has become clear why we have saved the square of the f-number on " -"the top of the FPU stack. The calculation of the f5.6 multiplier is the " -"easiest calculation of this entire program! We will output it rounded to " -"four significant digits." -msgstr "" -"Итак, теперь стало ясно, зачем мы сохранили квадрат числа f на вершине стека " -"FPU. Расчёт множителя для f5.6 — это самое простое вычисление во всей " -"программе! Мы выведем его, округлив до четырёх значащих цифр." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3231 -msgid "" -"There is one more useful number we can calculate: The number of stops our f-" -"number is from f5.6. This may help us if our f-number is just outside the " -"range of our light meter, but we have a shutter which lets us set various " -"speeds, and this shutter uses stops." -msgstr "" -"Есть ещё одно полезное число, которое мы можем вычислить: количество " -"ступеней, на которые наше значение диафрагмы отличается от f5.6. Это может " -"помочь, если наше значение диафрагмы находится чуть за пределами диапазона " -"нашего экспонометра, но у нас есть затвор, который позволяет устанавливать " -"различные выдержки, и этот затвор использует ступени." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3234 -msgid "" -"Say, our f-number is 5 stops from f5.6, and the light meter says we should " -"use 1/1000 sec. Then we can set our shutter speed to 1/1000 first, then " -"move the dial by 5 stops." -msgstr "" -"Предположим, наше число диафрагмы на 5 ступеней отличается от f5.6, а " -"экспонометр показывает, что нужно использовать выдержку 1/1000 сек. Тогда мы " -"можем сначала установить выдержку на 1/1000, а затем повернуть диск на 5 " -"ступеней." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3239 -msgid "" -"This calculation is quite easy as well. All we have to do is to calculate " -"the base-2 logarithm of the f5.6 multiplier we had just calculated (though " -"we need its value from before we rounded it off). We then output the result " -"rounded to the nearest integer. We do not need to worry about having more " -"than four significant digits in this one: The result is most likely to have " -"only one or two digits anyway." -msgstr "" -"Этот расчет также довольно прост. Все, что нам нужно сделать, это вычислить " -"логарифм по основанию 2 от множителя f5.6, который мы только что рассчитали (" -"хотя нам нужно его значение до округления). Затем мы выводим результат, " -"округленный до ближайшего целого числа. Нам не нужно беспокоиться о наличии " -"более четырёх значащих цифр в этом случае: скорее всего, результат будет " -"содержать только одну или две цифры." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3241 -#, no-wrap -msgid "FPU Optimizations" -msgstr "Оптимизации FPU" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3244 -msgid "" -"In assembly language we can optimize the FPU code in ways impossible in high " -"languages, including C." -msgstr "" -"В ассемблерном коде мы можем оптимизировать инструкции FPU способами, " -"невозможными в языках высокого уровня, включая C." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3248 -msgid "" -"Whenever a C function needs to calculate a floating-point value, it loads " -"all necessary variables and constants into FPU registers. It then does " -"whatever calculation is required to get the correct result. Good C " -"compilers can optimize that part of the code really well." -msgstr "" -"Всякий раз, когда функции на языке C требуется вычислить значение с " -"плавающей запятой, она загружает все необходимые переменные и константы в " -"регистры FPU. Затем выполняются все необходимые вычисления для получения " -"правильного результата. Хорошие компиляторы C могут очень эффективно " -"оптимизировать эту часть кода." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3252 -msgid "" -"It \"returns\" the value by leaving the result on the TOS. However, before " -"it returns, it cleans up. Any variables and constants it used in its " -"calculation are now gone from the FPU." -msgstr "" -"Он \"возвращает\" значение, оставляя результат на вершине стека (TOS). " -"Однако перед возвратом он выполняет очистку. Все переменные и константы, " -"использованные в вычислениях, теперь удалены из FPU." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3254 -msgid "" -"It cannot do what we just did above: We calculated the square of the f-" -"number and kept it on the stack for later use by another function." -msgstr "" -"Он не может сделать то, что мы только что сделали выше: мы вычислили квадрат " -"числа f и оставили его в стеке для последующего использования другой " -"функцией." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3257 -msgid "" -"We _knew_ we would need that value later on. We also knew we had enough " -"room on the stack (which only has room for 8 numbers) to store it there." -msgstr "" -"Мы _знали_, что это значение понадобится позже. Мы также знали, что у нас " -"достаточно места в стеке (в котором помещается только 8 чисел), чтобы " -"сохранить его там." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3259 -msgid "" -"A C compiler has no way of knowing that a value it has on the stack will be " -"required again in the very near future." -msgstr "" -"Компилятор C не может знать, что значение, находящееся в стеке, потребуется " -"снова в ближайшем будущем." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3262 -msgid "" -"Of course, the C programmer may know it. But the only recourse he has is to " -"store the value in a memory variable." -msgstr "" -"Конечно, программист на C может это знать. Но единственное средство, которое " -"у него есть, — это сохранить значение в переменной памяти." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3264 -msgid "" -"That means, for one, the value will be changed from the 80-bit precision " -"used internally by the FPU to a C _double_ (64 bits) or even _single_ (32 " -"bits)." -msgstr "" -"Это означает, что значение будет изменено с 80-битной точности, используемой " -"внутри FPU, на тип _double_ (64 бита) или даже _single_ (32 бита) в C." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3267 -msgid "" -"That also means that the value must be moved from the TOS into the memory, " -"and then back again. Alas, of all FPU operations, the ones that access the " -"computer memory are the slowest." -msgstr "" -"Это также означает, что значение должно быть перемещено из TOS в память, а " -"затем обратно. Увы, среди всех операций с FPU, доступ к памяти компьютера " -"является самым медленным." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3269 -msgid "" -"So, whenever programming the FPU in assembly language, look for the ways of " -"keeping intermediate results on the FPU stack." -msgstr "" -"Итак, при программировании FPU на языке ассемблера ищите способы хранения " -"промежуточных результатов в стеке FPU." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3271 -msgid "" -"We can take that idea even further! In our program we are using a _constant_ " -"(the one we named `PC`)." -msgstr "" -"Мы можем развить эту идею ещё дальше! В нашей программе мы используем " -"_константу_ (ту, которую назвали `PC`)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3274 -msgid "" -"It does not matter how many pinhole diameters we are calculating: 1, 10, 20, " -"1000, we are always using the same constant. Therefore, we can optimize our " -"program by keeping the constant on the stack all the time." -msgstr "" -"Не имеет значения, сколько диаметров отверстий мы рассчитываем: 1, 10, 20, " -"1000, мы всегда используем одну и ту же константу. Следовательно, мы можем " -"оптимизировать нашу программу, сохраняя константу в стеке всё время." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3277 -msgid "" -"Early on in our program, we are calculating the value of the above " -"constant. We need to divide our input by `10` for every digit in the " -"constant." -msgstr "" -"В начале нашей программы мы вычисляем значение указанной константы. Нам " -"нужно разделить наш вход на `10` для каждой цифры в константе." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3280 -msgid "" -"It is much faster to multiply than to divide. So, at the start of our " -"program, we divide `10` into `1` to obtain `0.1`, which we then keep on the " -"stack: Instead of dividing the input by `10` for every digit, we multiply it " -"by `0.1`." -msgstr "" -"Гораздо быстрее умножать, чем делить. Поэтому в начале нашей программы мы " -"делим `1` на `10`, чтобы получить `0.1`, который затем сохраняем в стеке: " -"вместо того чтобы делить ввод на `10` для каждой цифры, мы умножаем его на " -"`0.1`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3284 -msgid "" -"By the way, we do not input `0.1` directly, even though we could. We have a " -"reason for that: While `0.1` can be expressed with just one decimal place, " -"we do not know how many _binary_ places it takes. We, therefore, let the " -"FPU calculate its binary value to its own high precision." -msgstr "" -"Кстати, мы не вводим `0.1` напрямую, хотя могли бы. У нас есть причина для " -"этого: хотя `0.1` можно выразить всего одним десятичным знаком, мы не знаем, " -"сколько _двоичных_ разрядов для этого потребуется. Поэтому мы позволяем FPU " -"вычислить его двоичное значение с собственной высокой точностью." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3289 -msgid "" -"We are using other constants: We multiply the pinhole diameter by `1000` to " -"convert it from millimeters to microns. We compare numbers to `10000` when " -"we are rounding them off to four significant digits. So, we keep both, " -"`1000` and `10000`, on the stack. And, of course, we reuse the `0.1` when " -"rounding off numbers to four digits." -msgstr "" -"Мы используем другие константы: умножаем диаметр отверстия на `1000`, чтобы " -"перевести его из миллиметров в микроны. Мы сравниваем числа с `10000`, когда " -"округляем их до четырёх значащих цифр. Таким образом, мы оставляем и `1000`, " -"и `10000` в стеке. И, конечно же, мы повторно используем `0.1` при " -"округлении чисел до четырёх цифр." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3295 -msgid "" -"Last but not least, we keep `-5` on the stack. We need it to scale the " -"square of the f-number, instead of dividing it by `32`. It is not by " -"coincidence we load this constant last. That makes it the top of the stack " -"when only the constants are on it. So, when the square of the f-number is " -"being scaled, the `-5` is at `st(1)`, precisely where `fscale` expects it to " -"be." -msgstr "" -"И последнее, но не менее важное: мы оставляем `-5` в стеке. Он нам нужен для " -"масштабирования квадрата числа f вместо деления его на `32`. Не случайно мы " -"загружаем эту константу последней. Это делает её вершиной стека, когда в нём " -"находятся только константы. Таким образом, при масштабировании квадрата " -"число f `-5` находится в `st(1)`, именно там, где `fscale` ожидает его " -"увидеть." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3298 -msgid "" -"It is common to create certain constants from scratch instead of loading " -"them from the memory. That is what we are doing with `-5`:" -msgstr "" -"Это обычная ситуация, когда некоторые константы создаются с нуля, вместо " -"загрузки их из памяти. Именно это мы делаем с `-5`:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3307 -#, no-wrap -msgid "" -"\tfld1\t\t\t; TOS = 1\n" -"\tfadd\tst0, st0\t; TOS = 2\n" -"\tfadd\tst0, st0\t; TOS = 4\n" -"\tfld1\t\t\t; TOS = 1\n" -"\tfaddp\tst1, st0\t; TOS = 5\n" -"\tfchs\t\t\t; TOS = -5\n" -msgstr "" -"\tfld1\t\t\t; TOS = 1\n" -"\tfadd\tst0, st0\t; TOS = 2\n" -"\tfadd\tst0, st0\t; TOS = 4\n" -"\tfld1\t\t\t; TOS = 1\n" -"\tfaddp\tst1, st0\t; TOS = 5\n" -"\tfchs\t\t\t; TOS = -5\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3310 -msgid "" -"We can generalize all these optimizations into one rule: _Keep repeat values " -"on the stack!_" -msgstr "" -"Мы можем обобщить все эти оптимизации в одном правиле: _Держите " -"повторяющиеся значения в стеке!_" - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3315 -msgid "" -"_PostScript(R)_ is a stack-oriented programming language. There are many " -"more books available about PostScript(R) than about the FPU assembly " -"language: Mastering PostScript(R) will help you master the FPU." -msgstr "" -"_PostScript(R)_ — это стековая язык программирования. Существует гораздо " -"больше книг о PostScript(R), чем о языке ассемблера FPU: освоение " -"PostScript(R) поможет вам овладеть FPU." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3318 -#, no-wrap -msgid "pinhole-The Code" -msgstr "Код pinhole" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3333 -#, no-wrap -msgid "" -";;;;;;; pinhole.asm ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -";\n" -"; Find various parameters of a pinhole camera construction and use\n" -";\n" -"; Started:\t 9-Jun-2001\n" -"; Updated:\t10-Jun-2001\n" -";\n" -"; Copyright (c) 2001 G. Adam Stanislav\n" -"; All rights reserved.\n" -";\n" -";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -msgstr "" -";;;;;;; pinhole.asm ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" -";\n" -"; Find various parameters of a pinhole camera construction and use\n" -";\n" -"; Started:\t 9-Jun-2001\n" -"; Updated:\t10-Jun-2001\n" -";\n" -"; Copyright (c) 2001 G. Adam Stanislav\n" -"; All rights reserved.\n" -";\n" -";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3368 -#, no-wrap -msgid "" -"section\t.data\n" -"align 4\n" -"ten\tdd\t10\n" -"thousand\tdd\t1000\n" -"tthou\tdd\t10000\n" -"fd.in\tdd\tstdin\n" -"fd.out\tdd\tstdout\n" -"envar\tdb\t'PINHOLE='\t; Exactly 8 bytes, or 2 dwords long\n" -"pinhole\tdb\t'04,', \t\t; Bender's constant (0.04)\n" -"connors\tdb\t'037', 0Ah\t; Connors' constant\n" -"usg\tdb\t'Usage: pinhole [-b] [-c] [-e] [-p <value>] [-o <outfile>] [-i <infile>]', 0Ah\n" -"usglen\tequ\t$-usg\n" -"iemsg\tdb\t\"pinhole: Can't open input file\", 0Ah\n" -"iemlen\tequ\t$-iemsg\n" -"oemsg\tdb\t\"pinhole: Can't create output file\", 0Ah\n" -"oemlen\tequ\t$-oemsg\n" -"pinmsg\tdb\t\"pinhole: The PINHOLE constant must not be 0\", 0Ah\n" -"pinlen\tequ\t$-pinmsg\n" -"toobig\tdb\t\"pinhole: The PINHOLE constant may not exceed 18 decimal places\", 0Ah\n" -"biglen\tequ\t$-toobig\n" -"huhmsg\tdb\t9, '???'\n" -"separ\tdb\t9, '???'\n" -"sep2\tdb\t9, '???'\n" -"sep3\tdb\t9, '???'\n" -"sep4\tdb\t9, '???', 0Ah\n" -"huhlen\tequ\t$-huhmsg\n" -"header\tdb\t'focal length in millimeters,pinhole diameter in microns,'\n" -"\tdb\t'F-number,normalized F-number,F-5.6 multiplier,stops '\n" -"\tdb\t'from F-5.6', 0Ah\n" -"headlen\tequ\t$-header\n" -msgstr "" -"section\t.data\n" -"align 4\n" -"ten\tdd\t10\n" -"thousand\tdd\t1000\n" -"tthou\tdd\t10000\n" -"fd.in\tdd\tstdin\n" -"fd.out\tdd\tstdout\n" -"envar\tdb\t'PINHOLE='\t; Exactly 8 bytes, or 2 dwords long\n" -"pinhole\tdb\t'04,', \t\t; Bender's constant (0.04)\n" -"connors\tdb\t'037', 0Ah\t; Connors' constant\n" -"usg\tdb\t'Usage: pinhole [-b] [-c] [-e] [-p <value>] [-o <outfile>] [-i <infile>]', 0Ah\n" -"usglen\tequ\t$-usg\n" -"iemsg\tdb\t\"pinhole: Can't open input file\", 0Ah\n" -"iemlen\tequ\t$-iemsg\n" -"oemsg\tdb\t\"pinhole: Can't create output file\", 0Ah\n" -"oemlen\tequ\t$-oemsg\n" -"pinmsg\tdb\t\"pinhole: The PINHOLE constant must not be 0\", 0Ah\n" -"pinlen\tequ\t$-pinmsg\n" -"toobig\tdb\t\"pinhole: The PINHOLE constant may not exceed 18 decimal places\", 0Ah\n" -"biglen\tequ\t$-toobig\n" -"huhmsg\tdb\t9, '???'\n" -"separ\tdb\t9, '???'\n" -"sep2\tdb\t9, '???'\n" -"sep3\tdb\t9, '???'\n" -"sep4\tdb\t9, '???', 0Ah\n" -"huhlen\tequ\t$-huhmsg\n" -"header\tdb\t'focal length in millimeters,pinhole diameter in microns,'\n" -"\tdb\t'F-number,normalized F-number,F-5.6 multiplier,stops '\n" -"\tdb\t'from F-5.6', 0Ah\n" -"headlen\tequ\t$-header\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3374 -#, no-wrap -msgid "" -"section .bss\n" -"ibuffer\tresb\tBUFSIZE\n" -"obuffer\tresb\tBUFSIZE\n" -"dbuffer\tresb\t20\t\t; decimal input buffer\n" -"bbuffer\tresb\t10\t\t; BCD buffer\n" -msgstr "" -"section .bss\n" -"ibuffer\tresb\tBUFSIZE\n" -"obuffer\tresb\tBUFSIZE\n" -"dbuffer\tresb\t20\t\t; decimal input buffer\n" -"bbuffer\tresb\t10\t\t; BCD buffer\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3385 -#, no-wrap -msgid "" -"section\t.text\n" -"align 4\n" -"huh:\n" -"\tcall\twrite\n" -"\tpush\tdword huhlen\n" -"\tpush\tdword huhmsg\n" -"\tpush\tdword [fd.out]\n" -"\tsys.write\n" -"\tadd\tesp, byte 12\n" -"\tret\n" -msgstr "" -"section\t.text\n" -"align 4\n" -"huh:\n" -"\tcall\twrite\n" -"\tpush\tdword huhlen\n" -"\tpush\tdword huhmsg\n" -"\tpush\tdword [fd.out]\n" -"\tsys.write\n" -"\tadd\tesp, byte 12\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3394 -#, no-wrap -msgid "" -"align 4\n" -"perr:\n" -"\tpush\tdword pinlen\n" -"\tpush\tdword pinmsg\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" -"\tpush\tdword 4\t\t; return failure\n" -"\tsys.exit\n" -msgstr "" -"align 4\n" -"perr:\n" -"\tpush\tdword pinlen\n" -"\tpush\tdword pinmsg\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" -"\tpush\tdword 4\t\t; return failure\n" -"\tsys.exit\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3403 -#, no-wrap -msgid "" -"align 4\n" -"consttoobig:\n" -"\tpush\tdword biglen\n" -"\tpush\tdword toobig\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" -"\tpush\tdword 5\t\t; return failure\n" -"\tsys.exit\n" -msgstr "" -"align 4\n" -"consttoobig:\n" -"\tpush\tdword biglen\n" -"\tpush\tdword toobig\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" -"\tpush\tdword 5\t\t; return failure\n" -"\tsys.exit\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3412 -#, no-wrap -msgid "" -"align 4\n" -"ierr:\n" -"\tpush\tdword iemlen\n" -"\tpush\tdword iemsg\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" -"\tpush\tdword 1\t\t; return failure\n" -"\tsys.exit\n" -msgstr "" -"align 4\n" -"ierr:\n" -"\tpush\tdword iemlen\n" -"\tpush\tdword iemsg\n" -"\tpush\tdword stderr\n" -"\tsys.write\n" -"\tpush\tdword 1\t\t; return failure\n" -"\tsys.exit\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3436 -#, no-wrap -msgid "" -"align 4\n" -"global\t_start\n" -"_start:\n" -"\tadd\tesp, byte 8\t; discard argc and argv[0]\n" -"\tsub\tesi, esi\n" -msgstr "" -"align 4\n" -"global\t_start\n" -"_start:\n" -"\tadd\tesp, byte 8\t; discard argc and argv[0]\n" -"\tsub\tesi, esi\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3441 -#, no-wrap -msgid "" -".arg:\n" -"\tpop\tecx\n" -"\tor\tecx, ecx\n" -"\tje\tnear .getenv\t\t; no more arguments\n" -msgstr "" -".arg:\n" -"\tpop\tecx\n" -"\tor\tecx, ecx\n" -"\tje\tnear .getenv\t\t; no more arguments\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3449 -#, no-wrap -msgid "" -"\tinc\tecx\n" -"\tmov\tax, [ecx]\n" -"\tinc\tecx\n" -msgstr "" -"\tinc\tecx\n" -"\tmov\tax, [ecx]\n" -"\tinc\tecx\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3467 -#, no-wrap -msgid "" -"\tor\tah, ah\n" -"\tjne\t.openoutput\n" -"\tpop\tecx\n" -"\tjecxz\tusage\n" -msgstr "" -"\tor\tah, ah\n" -"\tjne\t.openoutput\n" -"\tpop\tecx\n" -"\tjecxz\tusage\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3494 -#, no-wrap -msgid "" -"\t; Find the path to the input file\n" -"\tor\tah, ah\n" -"\tjne\t.openinput\n" -"\tpop\tecx\n" -"\tor\tecx, ecx\n" -"\tje near usage\n" -msgstr "" -"\t; Find the path to the input file\n" -"\tor\tah, ah\n" -"\tjne\t.openinput\n" -"\tpop\tecx\n" -"\tor\tecx, ecx\n" -"\tje near usage\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3510 -#, no-wrap -msgid "" -".p:\n" -"\tcmp\tal, 'p'\n" -"\tjne\t.c\n" -"\tor\tah, ah\n" -"\tjne\t.pcheck\n" -msgstr "" -".p:\n" -"\tcmp\tal, 'p'\n" -"\tjne\t.c\n" -"\tor\tah, ah\n" -"\tjne\t.pcheck\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3514 -#, no-wrap -msgid "" -"\tpop\tecx\n" -"\tor\tecx, ecx\n" -"\tje\tnear usage\n" -msgstr "" -"\tpop\tecx\n" -"\tor\tecx, ecx\n" -"\tje\tnear usage\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3516 -#, no-wrap -msgid "\tmov\tah, [ecx]\n" -msgstr "\tmov\tah, [ecx]\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3524 -#, no-wrap -msgid "" -".pcheck:\n" -"\tcmp\tah, '0'\n" -"\tjl\tnear usage\n" -"\tcmp\tah, '9'\n" -"\tja\tnear usage\n" -"\tmov\tesi, ecx\n" -"\tjmp\t.arg\n" -msgstr "" -".pcheck:\n" -"\tcmp\tah, '0'\n" -"\tjl\tnear usage\n" -"\tcmp\tah, '9'\n" -"\tja\tnear usage\n" -"\tmov\tesi, ecx\n" -"\tjmp\t.arg\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3532 -#, no-wrap -msgid "" -".c:\n" -"\tcmp\tal, 'c'\n" -"\tjne\t.b\n" -"\tor\tah, ah\n" -"\tjne\tnear usage\n" -"\tmov\tesi, connors\n" -"\tjmp\t.arg\n" -msgstr "" -".c:\n" -"\tcmp\tal, 'c'\n" -"\tjne\t.b\n" -"\tor\tah, ah\n" -"\tjne\tnear usage\n" -"\tmov\tesi, connors\n" -"\tjmp\t.arg\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3540 -#, no-wrap -msgid "" -".b:\n" -"\tcmp\tal, 'b'\n" -"\tjne\t.e\n" -"\tor\tah, ah\n" -"\tjne\tnear usage\n" -"\tmov\tesi, pinhole\n" -"\tjmp\t.arg\n" -msgstr "" -".b:\n" -"\tcmp\tal, 'b'\n" -"\tjne\t.e\n" -"\tor\tah, ah\n" -"\tjne\tnear usage\n" -"\tmov\tesi, pinhole\n" -"\tjmp\t.arg\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3553 -#, no-wrap -msgid "" -".e:\n" -"\tcmp\tal, 'e'\n" -"\tjne\tnear usage\n" -"\tor\tah, ah\n" -"\tjne\tnear usage\n" -"\tmov\tal, ','\n" -"\tmov\t[huhmsg], al\n" -"\tmov\t[separ], al\n" -"\tmov\t[sep2], al\n" -"\tmov\t[sep3], al\n" -"\tmov\t[sep4], al\n" -"\tjmp\t.arg\n" -msgstr "" -".e:\n" -"\tcmp\tal, 'e'\n" -"\tjne\tnear usage\n" -"\tor\tah, ah\n" -"\tjne\tnear usage\n" -"\tmov\tal, ','\n" -"\tmov\t[huhmsg], al\n" -"\tmov\t[separ], al\n" -"\tmov\t[sep2], al\n" -"\tmov\t[sep3], al\n" -"\tmov\t[sep4], al\n" -"\tjmp\t.arg\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3560 -#, no-wrap -msgid "" -"align 4\n" -".getenv:\n" -"\t; If ESI = 0, we did not have a -p argument,\n" -"\t; and need to check the environment for \"PINHOLE=\"\n" -"\tor\tesi, esi\n" -"\tjne\t.init\n" -msgstr "" -"align 4\n" -".getenv:\n" -"\t; If ESI = 0, we did not have a -p argument,\n" -"\t; and need to check the environment for \"PINHOLE=\"\n" -"\tor\tesi, esi\n" -"\tjne\t.init\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3562 -#, no-wrap -msgid "\tsub\tecx, ecx\n" -msgstr "\tsub\tecx, ecx\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3567 -#, no-wrap -msgid "" -".nextenv:\n" -"\tpop\tesi\n" -"\tor\tesi, esi\n" -"\tje\t.default\t; no PINHOLE envar found\n" -msgstr "" -".nextenv:\n" -"\tpop\tesi\n" -"\tor\tesi, esi\n" -"\tje\t.default\t; no PINHOLE envar found\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3573 -#, no-wrap -msgid "" -"\t; check if this envar starts with 'PINHOLE='\n" -"\tmov\tedi, envar\n" -"\tmov\tcl, 2\t\t; 'PINHOLE=' is 2 dwords long\n" -"rep\tcmpsd\n" -"\tjne\t.nextenv\n" -msgstr "" -"\t; check if this envar starts with 'PINHOLE='\n" -"\tmov\tedi, envar\n" -"\tmov\tcl, 2\t\t; 'PINHOLE=' is 2 dwords long\n" -"rep\tcmpsd\n" -"\tjne\t.nextenv\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3581 -#, no-wrap -msgid "" -"\t; Check if it is followed by a digit\n" -"\tmov\tal, [esi]\n" -"\tcmp\tal, '0'\n" -"\tjl\t.default\n" -"\tcmp\tal, '9'\n" -"\tjbe\t.init\n" -"\t; fall through\n" -msgstr "" -"\t; Check if it is followed by a digit\n" -"\tmov\tal, [esi]\n" -"\tcmp\tal, '0'\n" -"\tjl\t.default\n" -"\tcmp\tal, '9'\n" -"\tjbe\t.init\n" -"\t; fall through\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3588 -#, no-wrap -msgid "" -"align 4\n" -".default:\n" -"\t; We got here because we had no -p argument,\n" -"\t; and did not find the PINHOLE envar.\n" -"\tmov\tesi, pinhole\n" -"\t; fall through\n" -msgstr "" -"align 4\n" -".default:\n" -"\t; We got here because we had no -p argument,\n" -"\t; and did not find the PINHOLE envar.\n" -"\tmov\tesi, pinhole\n" -"\t; fall through\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3597 -#, no-wrap -msgid "" -"align 4\n" -".init:\n" -"\tsub\teax, eax\n" -"\tsub\tebx, ebx\n" -"\tsub\tecx, ecx\n" -"\tsub\tedx, edx\n" -"\tmov\tedi, dbuffer+1\n" -"\tmov\tbyte [dbuffer], '0'\n" -msgstr "" -"align 4\n" -".init:\n" -"\tsub\teax, eax\n" -"\tsub\tebx, ebx\n" -"\tsub\tecx, ecx\n" -"\tsub\tedx, edx\n" -"\tmov\tedi, dbuffer+1\n" -"\tmov\tbyte [dbuffer], '0'\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3606 -#, no-wrap -msgid "" -"\t; Convert the pinhole constant to real\n" -".constloop:\n" -"\tlodsb\n" -"\tcmp\tal, '9'\n" -"\tja\t.setconst\n" -"\tcmp\tal, '0'\n" -"\tje\t.processconst\n" -"\tjb\t.setconst\n" -msgstr "" -"\t; Convert the pinhole constant to real\n" -".constloop:\n" -"\tlodsb\n" -"\tcmp\tal, '9'\n" -"\tja\t.setconst\n" -"\tcmp\tal, '0'\n" -"\tje\t.processconst\n" -"\tjb\t.setconst\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3608 -#, no-wrap -msgid "\tinc\tdl\n" -msgstr "\tinc\tdl\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3615 -#, no-wrap -msgid "" -".processconst:\n" -"\tinc\tcl\n" -"\tcmp\tcl, 18\n" -"\tja\tnear consttoobig\n" -"\tstosb\n" -"\tjmp\tshort .constloop\n" -msgstr "" -".processconst:\n" -"\tinc\tcl\n" -"\tcmp\tcl, 18\n" -"\tja\tnear consttoobig\n" -"\tstosb\n" -"\tjmp\tshort .constloop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3620 -#, no-wrap -msgid "" -"align 4\n" -".setconst:\n" -"\tor\tdl, dl\n" -"\tje\tnear perr\n" -msgstr "" -"align 4\n" -".setconst:\n" -"\tor\tdl, dl\n" -"\tje\tnear perr\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3623 -#, no-wrap -msgid "" -"\tfinit\n" -"\tfild\tdword [tthou]\n" -msgstr "" -"\tfinit\n" -"\tfild\tdword [tthou]\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3627 -#, no-wrap -msgid "" -"\tfld1\n" -"\tfild\tdword [ten]\n" -"\tfdivp\tst1, st0\n" -msgstr "" -"\tfld1\n" -"\tfild\tdword [ten]\n" -"\tfdivp\tst1, st0\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3630 -#, no-wrap -msgid "" -"\tfild\tdword [thousand]\n" -"\tmov\tedi, obuffer\n" -msgstr "" -"\tfild\tdword [thousand]\n" -"\tmov\tedi, obuffer\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3633 -#, no-wrap -msgid "" -"\tmov\tebp, ecx\n" -"\tcall\tbcdload\n" -msgstr "" -"\tmov\tebp, ecx\n" -"\tcall\tbcdload\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3637 -#, no-wrap -msgid "" -".constdiv:\n" -"\tfmul\tst0, st2\n" -"\tloop\t.constdiv\n" -msgstr "" -".constdiv:\n" -"\tfmul\tst0, st2\n" -"\tloop\t.constdiv\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3644 -#, no-wrap -msgid "" -"\tfld1\n" -"\tfadd\tst0, st0\n" -"\tfadd\tst0, st0\n" -"\tfld1\n" -"\tfaddp\tst1, st0\n" -"\tfchs\n" -msgstr "" -"\tfld1\n" -"\tfadd\tst0, st0\n" -"\tfadd\tst0, st0\n" -"\tfld1\n" -"\tfaddp\tst1, st0\n" -"\tfchs\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3649 -#, no-wrap -msgid "" -"\t; If we are creating a CSV file,\n" -"\t; print header\n" -"\tcmp\tbyte [separ], ','\n" -"\tjne\t.bigloop\n" -msgstr "" -"\t; If we are creating a CSV file,\n" -"\t; print header\n" -"\tcmp\tbyte [separ], ','\n" -"\tjne\t.bigloop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3654 -#, no-wrap -msgid "" -"\tpush\tdword headlen\n" -"\tpush\tdword header\n" -"\tpush\tdword [fd.out]\n" -"\tsys.write\n" -msgstr "" -"\tpush\tdword headlen\n" -"\tpush\tdword header\n" -"\tpush\tdword [fd.out]\n" -"\tsys.write\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3658 -#, no-wrap -msgid "" -".bigloop:\n" -"\tcall\tgetchar\n" -"\tjc\tnear done\n" -msgstr "" -".bigloop:\n" -"\tcall\tgetchar\n" -"\tjc\tnear done\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3664 -#, no-wrap -msgid "" -"\t; Skip to the end of the line if you got '#'\n" -"\tcmp\tal, '#'\n" -"\tjne\t.num\n" -"\tcall\tskiptoeol\n" -"\tjmp\tshort .bigloop\n" -msgstr "" -"\t; Skip to the end of the line if you got '#'\n" -"\tcmp\tal, '#'\n" -"\tjne\t.num\n" -"\tcall\tskiptoeol\n" -"\tjmp\tshort .bigloop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3671 -#, no-wrap -msgid "" -".num:\n" -"\t; See if you got a number\n" -"\tcmp\tal, '0'\n" -"\tjl\t.bigloop\n" -"\tcmp\tal, '9'\n" -"\tja\t.bigloop\n" -msgstr "" -".num:\n" -"\t; See if you got a number\n" -"\tcmp\tal, '0'\n" -"\tjl\t.bigloop\n" -"\tcmp\tal, '9'\n" -"\tja\t.bigloop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3675 -#, no-wrap -msgid "" -"\t; Yes, we have a number\n" -"\tsub\tebp, ebp\n" -"\tsub\tedx, edx\n" -msgstr "" -"\t; Yes, we have a number\n" -"\tsub\tebp, ebp\n" -"\tsub\tedx, edx\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3680 -#, no-wrap -msgid "" -".number:\n" -"\tcmp\tal, '0'\n" -"\tje\t.number0\n" -"\tmov\tdl, 1\n" -msgstr "" -".number:\n" -"\tcmp\tal, '0'\n" -"\tje\t.number0\n" -"\tmov\tdl, 1\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3691 -#, no-wrap -msgid "" -".number0:\n" -"\tor\tdl, dl\t\t; Skip leading 0's\n" -"\tje\t.nextnumber\n" -"\tpush\teax\n" -"\tcall\tputchar\n" -"\tpop\teax\n" -"\tinc\tebp\n" -"\tcmp\tebp, 19\n" -"\tjae\t.nextnumber\n" -"\tmov\t[dbuffer+ebp], al\n" -msgstr "" -".number0:\n" -"\tor\tdl, dl\t\t; Skip leading 0's\n" -"\tje\t.nextnumber\n" -"\tpush\teax\n" -"\tcall\tputchar\n" -"\tpop\teax\n" -"\tinc\tebp\n" -"\tcmp\tebp, 19\n" -"\tjae\t.nextnumber\n" -"\tmov\t[dbuffer+ebp], al\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3702 -#, no-wrap -msgid "" -".nextnumber:\n" -"\tcall\tgetchar\n" -"\tjc\t.work\n" -"\tcmp\tal, '#'\n" -"\tje\t.ungetc\n" -"\tcmp\tal, '0'\n" -"\tjl\t.work\n" -"\tcmp\tal, '9'\n" -"\tja\t.work\n" -"\tjmp\tshort .number\n" -msgstr "" -".nextnumber:\n" -"\tcall\tgetchar\n" -"\tjc\t.work\n" -"\tcmp\tal, '#'\n" -"\tje\t.ungetc\n" -"\tcmp\tal, '0'\n" -"\tjl\t.work\n" -"\tcmp\tal, '9'\n" -"\tja\t.work\n" -"\tjmp\tshort .number\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3706 -#, no-wrap -msgid "" -".ungetc:\n" -"\tdec\tesi\n" -"\tinc\tebx\n" -msgstr "" -".ungetc:\n" -"\tdec\tesi\n" -"\tinc\tebx\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3711 -#, no-wrap -msgid "" -".work:\n" -"\t; Now, do all the work\n" -"\tor\tdl, dl\n" -"\tje\tnear .work0\n" -msgstr "" -".work:\n" -"\t; Now, do all the work\n" -"\tor\tdl, dl\n" -"\tje\tnear .work0\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3714 -#, no-wrap -msgid "" -"\tcmp\tebp, 19\n" -"\tjae\tnear .toobig\n" -msgstr "" -"\tcmp\tebp, 19\n" -"\tjae\tnear .toobig\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3716 -#, no-wrap -msgid "\tcall\tbcdload\n" -msgstr "\tcall\tbcdload\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3718 -#, no-wrap -msgid "\t; Calculate pinhole diameter\n" -msgstr "\t; Calculate pinhole diameter\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3725 -#, no-wrap -msgid "" -"\tfld\tst0\t; save it\n" -"\tfsqrt\n" -"\tfmul\tst0, st3\n" -"\tfld\tst0\n" -"\tfmul\tst5\n" -"\tsub\tebp, ebp\n" -msgstr "" -"\tfld\tst0\t; save it\n" -"\tfsqrt\n" -"\tfmul\tst0, st3\n" -"\tfld\tst0\n" -"\tfmul\tst5\n" -"\tsub\tebp, ebp\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3735 -#, no-wrap -msgid "" -"\t; Round off to 4 significant digits\n" -".diameter:\n" -"\tfcom\tst0, st7\n" -"\tfstsw\tax\n" -"\tsahf\n" -"\tjb\t.printdiameter\n" -"\tfmul\tst0, st6\n" -"\tinc\tebp\n" -"\tjmp\tshort .diameter\n" -msgstr "" -"\t; Round off to 4 significant digits\n" -".diameter:\n" -"\tfcom\tst0, st7\n" -"\tfstsw\tax\n" -"\tsahf\n" -"\tjb\t.printdiameter\n" -"\tfmul\tst0, st6\n" -"\tinc\tebp\n" -"\tjmp\tshort .diameter\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3738 -#, no-wrap -msgid "" -".printdiameter:\n" -"\tcall\tprintnumber\t; pinhole diameter\n" -msgstr "" -".printdiameter:\n" -"\tcall\tprintnumber\t; pinhole diameter\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3740 -#, no-wrap -msgid "\t; Calculate F-number\n" -msgstr "\t; Calculate F-number\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3743 -#, no-wrap -msgid "" -"\tfdivp\tst1, st0\n" -"\tfld\tst0\n" -msgstr "" -"\tfdivp\tst1, st0\n" -"\tfld\tst0\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3745 -#, no-wrap -msgid "\tsub\tebp, ebp\n" -msgstr "\tsub\tebp, ebp\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3754 -#, no-wrap -msgid "" -".fnumber:\n" -"\tfcom\tst0, st6\n" -"\tfstsw\tax\n" -"\tsahf\n" -"\tjb\t.printfnumber\n" -"\tfmul\tst0, st5\n" -"\tinc\tebp\n" -"\tjmp\tshort .fnumber\n" -msgstr "" -".fnumber:\n" -"\tfcom\tst0, st6\n" -"\tfstsw\tax\n" -"\tsahf\n" -"\tjb\t.printfnumber\n" -"\tfmul\tst0, st5\n" -"\tinc\tebp\n" -"\tjmp\tshort .fnumber\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3757 -#, no-wrap -msgid "" -".printfnumber:\n" -"\tcall\tprintnumber\t; F number\n" -msgstr "" -".printfnumber:\n" -"\tcall\tprintnumber\t; F number\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3768 -#, no-wrap -msgid "" -"\t; Calculate normalized F-number\n" -"\tfmul\tst0, st0\n" -"\tfld1\n" -"\tfld\tst1\n" -"\tfyl2x\n" -"\tfrndint\n" -"\tfld1\n" -"\tfscale\n" -"\tfsqrt\n" -"\tfstp\tst1\n" -msgstr "" -"\t; Calculate normalized F-number\n" -"\tfmul\tst0, st0\n" -"\tfld1\n" -"\tfld\tst1\n" -"\tfyl2x\n" -"\tfrndint\n" -"\tfld1\n" -"\tfscale\n" -"\tfsqrt\n" -"\tfstp\tst1\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3771 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3799 -#, no-wrap -msgid "" -"\tsub\tebp, ebp\n" -"\tcall\tprintnumber\n" -msgstr "" -"\tsub\tebp, ebp\n" -"\tcall\tprintnumber\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3773 -#, no-wrap -msgid "\t; Calculate time multiplier from F-5.6\n" -msgstr "\t; Calculate time multiplier from F-5.6\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3776 -#, no-wrap -msgid "" -"\tfscale\n" -"\tfld\tst0\n" -msgstr "" -"\tfscale\n" -"\tfld\tst0\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3782 -#, no-wrap -msgid "" -"\t; Round off to 4 significant digits\n" -".fmul:\n" -"\tfcom\tst0, st6\n" -"\tfstsw\tax\n" -"\tsahf\n" -msgstr "" -"\t; Round off to 4 significant digits\n" -".fmul:\n" -"\tfcom\tst0, st6\n" -"\tfstsw\tax\n" -"\tsahf\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3787 -#, no-wrap -msgid "" -"\tjb\t.printfmul\n" -"\tinc\tebp\n" -"\tfmul\tst0, st5\n" -"\tjmp\tshort .fmul\n" -msgstr "" -"\tjb\t.printfmul\n" -"\tinc\tebp\n" -"\tfmul\tst0, st5\n" -"\tjmp\tshort .fmul\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3790 -#, no-wrap -msgid "" -".printfmul:\n" -"\tcall\tprintnumber\t; F multiplier\n" -msgstr "" -".printfmul:\n" -"\tcall\tprintnumber\t; F multiplier\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3792 -#, no-wrap -msgid "\t; Calculate F-stops from 5.6\n" -msgstr "\t; Calculate F-stops from 5.6\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3796 -#, no-wrap -msgid "" -"\tfld1\n" -"\tfxch\tst1\n" -"\tfyl2x\n" -msgstr "" -"\tfld1\n" -"\tfxch\tst1\n" -"\tfyl2x\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3803 -#, no-wrap -msgid "" -"\tmov\tal, 0Ah\n" -"\tcall\tputchar\n" -"\tjmp\t.bigloop\n" -msgstr "" -"\tmov\tal, 0Ah\n" -"\tcall\tputchar\n" -"\tjmp\t.bigloop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3807 -#, no-wrap -msgid "" -".work0:\n" -"\tmov\tal, '0'\n" -"\tcall\tputchar\n" -msgstr "" -".work0:\n" -"\tmov\tal, '0'\n" -"\tcall\tputchar\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3812 -#, no-wrap -msgid "" -"align 4\n" -".toobig:\n" -"\tcall\thuh\n" -"\tjmp\t.bigloop\n" -msgstr "" -"align 4\n" -".toobig:\n" -"\tcall\thuh\n" -"\tjmp\t.bigloop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3816 -#, no-wrap -msgid "" -"align 4\n" -"done:\n" -"\tcall\twrite\t\t; flush output buffer\n" -msgstr "" -"align 4\n" -"done:\n" -"\tcall\twrite\t\t; flush output buffer\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3825 -#, no-wrap -msgid "\tfinit\n" -msgstr "\tfinit\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3838 -#, no-wrap -msgid "" -"align 4\n" -"skiptoeol:\n" -"\t; Keep reading until you come to cr, lf, or eof\n" -"\tcall\tgetchar\n" -"\tjc\tdone\n" -"\tcmp\tal, 0Ah\n" -"\tjne\t.cr\n" -"\tret\n" -msgstr "" -"align 4\n" -"skiptoeol:\n" -"\t; Keep reading until you come to cr, lf, or eof\n" -"\tcall\tgetchar\n" -"\tjc\tdone\n" -"\tcmp\tal, 0Ah\n" -"\tjne\t.cr\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3843 -#, no-wrap -msgid "" -".cr:\n" -"\tcmp\tal, 0Dh\n" -"\tjne\tskiptoeol\n" -"\tret\n" -msgstr "" -".cr:\n" -"\tcmp\tal, 0Dh\n" -"\tjne\tskiptoeol\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3856 -#, no-wrap -msgid "" -".fetch:\n" -"\tlodsb\n" -"\tdec\tebx\n" -"\tclc\n" -"\tret\n" -msgstr "" -".fetch:\n" -"\tlodsb\n" -"\tdec\tebx\n" -"\tclc\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3873 -#, no-wrap -msgid "" -".read:\n" -"\tpush\tdword BUFSIZE\n" -"\tmov\tesi, ibuffer\n" -"\tpush\tesi\n" -"\tpush\tdword [fd.in]\n" -"\tsys.read\n" -"\tadd\tesp, byte 12\n" -"\tmov\tebx, eax\n" -"\tor\teax, eax\n" -"\tje\t.empty\n" -"\tsub\teax, eax\n" -"\tret\n" -msgstr "" -".read:\n" -"\tpush\tdword BUFSIZE\n" -"\tmov\tesi, ibuffer\n" -"\tpush\tesi\n" -"\tpush\tdword [fd.in]\n" -"\tsys.read\n" -"\tadd\tesp, byte 12\n" -"\tmov\tebx, eax\n" -"\tor\teax, eax\n" -"\tje\t.empty\n" -"\tsub\teax, eax\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3879 -#, no-wrap -msgid "" -"align 4\n" -".empty:\n" -"\tadd\tesp, byte 4\n" -"\tstc\n" -"\tret\n" -msgstr "" -"align 4\n" -".empty:\n" -"\tadd\tesp, byte 4\n" -"\tstc\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3908 -#, no-wrap -msgid "" -"align 4\n" -"bcdload:\n" -"\t; EBP contains the number of chars in dbuffer\n" -"\tpush\tecx\n" -"\tpush\tesi\n" -"\tpush\tedi\n" -msgstr "" -"align 4\n" -"bcdload:\n" -"\t; EBP contains the number of chars in dbuffer\n" -"\tpush\tecx\n" -"\tpush\tesi\n" -"\tpush\tedi\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3912 -#, no-wrap -msgid "" -"\tlea\tecx, [ebp+1]\n" -"\tlea\tesi, [dbuffer+ebp-1]\n" -"\tshr\tecx, 1\n" -msgstr "" -"\tlea\tecx, [ebp+1]\n" -"\tlea\tesi, [dbuffer+ebp-1]\n" -"\tshr\tecx, 1\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3914 -#, no-wrap -msgid "\tstd\n" -msgstr "\tstd\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3920 -#, no-wrap -msgid "" -"\tmov\tedi, bbuffer\n" -"\tsub\teax, eax\n" -"\tmov\t[edi], eax\n" -"\tmov\t[edi+4], eax\n" -"\tmov\t[edi+2], ax\n" -msgstr "" -"\tmov\tedi, bbuffer\n" -"\tsub\teax, eax\n" -"\tmov\t[edi], eax\n" -"\tmov\t[edi+4], eax\n" -"\tmov\t[edi+2], ax\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3929 -#, no-wrap -msgid "" -".loop:\n" -"\tlodsw\n" -"\tsub\tax, 3030h\n" -"\tshl\tal, 4\n" -"\tor\tal, ah\n" -"\tmov\t[edi], al\n" -"\tinc\tedi\n" -"\tloop\t.loop\n" -msgstr "" -".loop:\n" -"\tlodsw\n" -"\tsub\tax, 3030h\n" -"\tshl\tal, 4\n" -"\tor\tal, ah\n" -"\tmov\t[edi], al\n" -"\tinc\tedi\n" -"\tloop\t.loop\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3931 -#, no-wrap -msgid "\tfbld\t[bbuffer]\n" -msgstr "\tfbld\t[bbuffer]\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3938 -#, no-wrap -msgid "" -"\tcld\n" -"\tpop\tedi\n" -"\tpop\tesi\n" -"\tpop\tecx\n" -"\tsub\teax, eax\n" -"\tret\n" -msgstr "" -"\tcld\n" -"\tpop\tedi\n" -"\tpop\tesi\n" -"\tpop\tecx\n" -"\tsub\teax, eax\n" -"\tret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3944 -#, no-wrap -msgid "" -"align 4\n" -"printnumber:\n" -"\tpush\tebp\n" -"\tmov\tal, [separ]\n" -"\tcall\tputchar\n" -msgstr "" -"align 4\n" -"printnumber:\n" -"\tpush\tebp\n" -"\tmov\tal, [separ]\n" -"\tcall\tputchar\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3948 -#, no-wrap -msgid "" -"\t; Print the integer at the TOS\n" -"\tmov\tebp, bbuffer+9\n" -"\tfbstp\t[bbuffer]\n" -msgstr "" -"\t; Print the integer at the TOS\n" -"\tmov\tebp, bbuffer+9\n" -"\tfbstp\t[bbuffer]\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3954 -#, no-wrap -msgid "" -"\t; Check the sign\n" -"\tmov\tal, [ebp]\n" -"\tdec\tebp\n" -"\tor\tal, al\n" -"\tjns\t.leading\n" -msgstr "" -"\t; Check the sign\n" -"\tmov\tal, [ebp]\n" -"\tdec\tebp\n" -"\tor\tal, al\n" -"\tjns\t.leading\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3958 -#, no-wrap -msgid "" -"\t; We got a negative number (should never happen)\n" -"\tmov\tal, '-'\n" -"\tcall\tputchar\n" -msgstr "" -"\t; We got a negative number (should never happen)\n" -"\tmov\tal, '-'\n" -"\tcall\tputchar\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3967 -#, no-wrap -msgid "" -".leading:\n" -"\t; Skip leading zeros\n" -"\tmov\tal, [ebp]\n" -"\tdec\tebp\n" -"\tor\tal, al\n" -"\tjne\t.first\n" -"\tcmp\tebp, bbuffer\n" -"\tjae\t.leading\n" -msgstr "" -".leading:\n" -"\t; Skip leading zeros\n" -"\tmov\tal, [ebp]\n" -"\tdec\tebp\n" -"\tor\tal, al\n" -"\tjne\t.first\n" -"\tcmp\tebp, bbuffer\n" -"\tjae\t.leading\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3972 -#, no-wrap -msgid "" -"\t; We are here because the result was 0.\n" -"\t; Print '0' and return\n" -"\tmov\tal, '0'\n" -"\tjmp\tputchar\n" -msgstr "" -"\t; We are here because the result was 0.\n" -"\t; Print '0' and return\n" -"\tmov\tal, '0'\n" -"\tjmp\tputchar\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3984 -#, no-wrap -msgid "" -".first:\n" -"\t; We have found the first non-zero.\n" -"\t; But it is still packed\n" -"\ttest\tal, 0F0h\n" -"\tjz\t.second\n" -"\tpush\teax\n" -"\tshr\tal, 4\n" -"\tadd\tal, '0'\n" -"\tcall\tputchar\n" -"\tpop\teax\n" -"\tand\tal, 0Fh\n" -msgstr "" -".first:\n" -"\t; We have found the first non-zero.\n" -"\t; But it is still packed\n" -"\ttest\tal, 0F0h\n" -"\tjz\t.second\n" -"\tpush\teax\n" -"\tshr\tal, 4\n" -"\tadd\tal, '0'\n" -"\tcall\tputchar\n" -"\tpop\teax\n" -"\tand\tal, 0Fh\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3988 -#, no-wrap -msgid "" -".second:\n" -"\tadd\tal, '0'\n" -"\tcall\tputchar\n" -msgstr "" -".second:\n" -"\tadd\tal, '0'\n" -"\tcall\tputchar\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:3992 -#, no-wrap -msgid "" -".next:\n" -"\tcmp\tebp, bbuffer\n" -"\tjb\t.done\n" -msgstr "" -".next:\n" -"\tcmp\tebp, bbuffer\n" -"\tjb\t.done\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4002 -#, no-wrap -msgid "" -"\tmov\tal, [ebp]\n" -"\tpush\teax\n" -"\tshr\tal, 4\n" -"\tadd\tal, '0'\n" -"\tcall\tputchar\n" -"\tpop\teax\n" -"\tand\tal, 0Fh\n" -"\tadd\tal, '0'\n" -"\tcall\tputchar\n" -msgstr "" -"\tmov\tal, [ebp]\n" -"\tpush\teax\n" -"\tshr\tal, 4\n" -"\tadd\tal, '0'\n" -"\tcall\tputchar\n" -"\tpop\teax\n" -"\tand\tal, 0Fh\n" -"\tadd\tal, '0'\n" -"\tcall\tputchar\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4005 -#, no-wrap -msgid "" -"\tdec\tebp\n" -"\tjmp\tshort .next\n" -msgstr "" -"\tdec\tebp\n" -"\tjmp\tshort .next\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4010 -#, no-wrap -msgid "" -".done:\n" -"\tpop\tebp\n" -"\tor\tebp, ebp\n" -"\tje\t.ret\n" -msgstr "" -".done:\n" -"\tpop\tebp\n" -"\tor\tebp, ebp\n" -"\tje\t.ret\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4016 -#, no-wrap -msgid "" -".zeros:\n" -"\tmov\tal, '0'\n" -"\tcall\tputchar\n" -"\tdec\tebp\n" -"\tjne\t.zeros\n" -msgstr "" -".zeros:\n" -"\tmov\tal, '0'\n" -"\tcall\tputchar\n" -"\tdec\tebp\n" -"\tjne\t.zeros\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4019 -#, no-wrap -msgid "" -".ret:\n" -"\tret\n" -msgstr "" -".ret:\n" -"\tret\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4022 -msgid "" -"The code follows the same format as all the other filters we have seen " -"before, with one subtle exception:" -msgstr "" -"Код следует тому же формату, что и все остальные фильтры, которые мы видели " -"ранее, с одним небольшим исключением:" - -#. type: delimited block _ 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4025 -msgid "" -"We are no longer assuming that the end of input implies the end of things to " -"do, something we took for granted in the _character-oriented_ filters." -msgstr "" -"Мы больше не предполагаем, что конец ввода означает конец задач, как мы " -"привыкли в фильтрах, _ориентированных на символы_." - -#. type: delimited block _ 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4027 -msgid "" -"This filter does not process characters. It processes a _language_ (albeit a " -"very simple one, consisting only of numbers)." -msgstr "" -"Этот фильтр не обрабатывает символы. Он обрабатывает _язык_ (хотя и очень " -"простой, состоящий только из чисел)." - -#. type: delimited block _ 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4029 -msgid "When we have no more input, it can mean one of two things:" -msgstr "" -"Когда у нас больше нет входных данных, это может означать одно из двух:" - -#. type: delimited block _ 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4031 -msgid "We are done and can quit. This is the same as before." -msgstr "Мы закончили и можем выйти. Это то же самое, что и раньше." - -#. type: delimited block _ 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4032 -msgid "" -"The last character we have read was a digit. We have stored it at the end of " -"our ASCII-to-float conversion buffer. We now need to convert the contents of " -"that buffer into a number and write the last line of our output." -msgstr "" -"Последний прочитанный символ был цифрой. Мы сохранили его в конце буфера " -"преобразования ASCII в число с плавающей точкой. Теперь нам нужно " -"преобразовать содержимое этого буфера в число и записать последнюю строку " -"нашего вывода." - -#. type: delimited block _ 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4034 -msgid "" -"For that reason, we have modified our `getchar` and our `read` routines to " -"return with the `carry flag` _clear_ whenever we are fetching another " -"character from the input, or the `carry flag` _set_ whenever there is no " -"more input." -msgstr "" -"По этой причине мы изменили наши подпрограммы `getchar` и `read`, чтобы они " -"возвращались с _сброшенным_ флагом `carry`, когда получают очередной символ " -"из ввода, или с _установленным_ флагом `carry`, когда ввода больше нет." - -#. type: delimited block _ 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4037 -msgid "" -"Of course, we are still using assembly language magic to do that! Take a " -"good look at `getchar`. It _always_ returns with the `carry flag` _clear_." -msgstr "" -"Конечно, мы по-прежнему используем магию ассемблера для этого! Внимательно " -"посмотрите на `getchar`. Он _всегда_ возвращает _очищенный_ `флаг переноса`." - -#. type: delimited block _ 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4039 -msgid "" -"Yet, our main code relies on the `carry flag` to tell it when to quit-and it " -"works." -msgstr "" -"Тем не менее, наш основной код использует `флаг переноса` для определения " -"момента завершения — и это работает." - -#. type: delimited block _ 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4042 -msgid "" -"The magic is in `read`. Whenever it receives more input from the system, it " -"just returns to `getchar`, which fetches a character from the input buffer, " -"_clears_ the `carry flag` and returns." -msgstr "" -"Волшебство кроется в `read`. Каждый раз, когда он получает больше входных " -"данных от системы, он просто возвращается к `getchar`, который извлекает " -"символ из входного буфера, _сбрасывает_ флаг переноса (`carry flag`) и " -"возвращает управление." - -#. type: delimited block _ 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4045 -msgid "" -"But when `read` receives no more input from the system, it does _not_ return " -"to `getchar` at all. Instead, the `add esp, byte 4` op code adds `4` to " -"`ESP`, _sets_ the `carry flag`, and returns." -msgstr "" -"Но когда `read` больше не получает входных данных от системы, он _не_ " -"возвращается к `getchar` вообще. Вместо этого, инструкция `add esp, byte 4` " -"добавляет `4` к `ESP`, _устанавливает_ флаг переноса (`carry flag`) и " -"возвращает управление." - -#. type: delimited block _ 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4049 -msgid "" -"So, where does it return to? Whenever a program uses the `call` op code, the " -"microprocessor ``push``es the return address, i.e., it stores it on the top " -"of the stack (not the FPU stack, the system stack, which is in the memory). " -"When a program uses the `ret` op code, the microprocessor ``pop``s the " -"return value from the stack, and jumps to the address that was stored there." -msgstr "" -"Итак, куда же она возвращается? Каждый раз, когда программа использует " -"операцию `call`, микропроцессор делает ``push`` для адрес возврата, то есть " -"сохраняет его на вершине стека (не стека FPU, а системного стека, который " -"находится в памяти). Когда программа использует операцию `ret`, " -"микропроцессор делает ``pop`` для значения возврата из стека и переходит по " -"адресу, который там был сохранён." - -#. type: delimited block _ 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4051 -msgid "" -"But since we added `4` to `ESP` (which is the stack pointer register), we " -"have effectively given the microprocessor a minor case of _amnesia_: It no " -"longer remembers it was `getchar` that ``call``ed `read`." -msgstr "" -"Но поскольку мы добавили `4` к `ESP` (который является регистром указателя " -"стека), мы фактически вызвали у микропроцессора лёгкий случай _амнезии_: он " -"больше не помнит, что именно `getchar` ``вызвал`` `read`." - -#. type: delimited block _ 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4053 -msgid "" -"And since `getchar` never ``push``ed anything before ``call``ing `read`, the " -"top of the stack now contains the return address to whatever or whoever " -"``call``ed `getchar`. As far as that caller is concerned, he ``call``ed " -"`getchar`, which ``ret``urned with the `carry flag` set!" -msgstr "" -"И поскольку `getchar` не делал ``push`` ни для чего перед вызовом `read`, " -"верхушка стека теперь содержит адрес возврата к тому, что или кто вызывал " -"`getchar`. С точки зрения этого вызывающего, он вызывал `getchar`, который " -"вызвал ``ret`` с установленным `флагом переноса`!" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4056 -msgid "" -"Other than that, the `bcdload` routine is caught up in the middle of a " -"Lilliputian conflict between the Big-Endians and the Little-Endians." -msgstr "" -"Помимо этого, процедура `bcdload` оказывается втянута в лилипутский конфликт " -"между Биг-Эндианцами и Литл-Эндианцами." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4058 -msgid "" -"It is converting the text representation of a number into that number: The " -"text is stored in the big-endian order, but the _packed decimal_ is little-" -"endian." -msgstr "" -"Он преобразует текстовое представление числа в само число: текст хранится в " -"порядке big-endian, но _упакованный десятичный_ формат имеет порядок little-" -"endian." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4061 -msgid "" -"To solve the conflict, we use the `std` op code early on. We cancel it with " -"`cld` later on: It is quite important we do not `call` anything that may " -"depend on the default setting of the _direction flag_ while `std` is active." -msgstr "" -"Для разрешения конфликта мы используем инструкцию процессора `std` в самом " -"начале. Позже мы отменяем его с помощью `cld`: очень важно не вызывать " -"ничего, что может зависеть от стандартного значения _флага направления_, " -"пока активен `std`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4063 -msgid "" -"Everything else in this code should be quit eclear, providing you have read " -"the entire chapter that precedes it." -msgstr "" -"Всё остальное в этом коде должно быть достаточно понятным, при условии, что " -"вы прочитали всю предшествующую главу." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4066 -msgid "" -"It is a classical example of the adage that programming requires a lot of " -"thought and only a little coding. Once we have thought through every tiny " -"detail, the code almost writes itself." -msgstr "" -"Это классический пример поговорки о том, что программирование требует много " -"размышлений и лишь немного кодирования. Как только мы продумаем каждую " -"мельчайшую деталь, код практически напишется сам." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4068 -#, no-wrap -msgid "Using pinhole" -msgstr "Использование программы pinhole" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4072 -msgid "" -"Because we have decided to make the program _ignore_ any input except for " -"numbers (and even those inside a comment), we can actually perform _textual " -"queries_. We do not _have to_, but we _can_." -msgstr "" -"Поскольку мы решили сделать так, чтобы программа _игнорировала_ любой ввод, " -"кроме чисел (и даже их внутри комментария), мы можем выполнять _текстовые " -"запросы_. Мы не _обязаны_ этого делать, но _можем_." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4074 -msgid "" -"In my humble opinion, forming a textual query, instead of having to follow a " -"very strict syntax, makes software much more user friendly." -msgstr "" -"По моему скромному мнению, формирование текстового запроса вместо " -"необходимости следовать очень строгому синтаксису делает программное " -"обеспечение гораздо более дружелюбным к пользователю." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4080 -msgid "" -"Suppose we want to build a pinhole camera to use the 4x5 inch film. The " -"standard focal length for that film is about 150mm. We want to _fine-tune_ " -"our focal length so the pinhole diameter is as round a number as possible. " -"Let us also suppose we are quite comfortable with cameras but somewhat " -"intimidated by computers. Rather than just have to type in a bunch of " -"numbers, we want to _ask_ a couple of questions." -msgstr "" -"Предположим, мы хотим построить камеру-обскуру для использования плёнки " -"размером 4x5 дюймов. Стандартное фокусное расстояние для такой плёнки " -"составляет около 150 мм. Мы хотим _точно настроить_ фокусное расстояние, " -"чтобы диаметр отверстия был как можно более круглым числом. Допустим также, " -"что мы хорошо разбираемся в фотоаппаратах, но немного боимся компьютеров. " -"Вместо того чтобы просто вводить кучу цифр, мы хотим _задать_ пару вопросов." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4082 -msgid "Our session might look like this:" -msgstr "Наша сессия может выглядеть так:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4086 -#, no-wrap -msgid "% pinhole\n" -msgstr "% pinhole\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4088 -#, no-wrap -msgid "Computer,\n" -msgstr "Computer,\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4101 -#, no-wrap -msgid "" -"What size pinhole do I need for the focal length of 150?\n" -"150\t490\t306\t362\t2930\t12\n" -"Hmmm... How about 160?\n" -"160\t506\t316\t362\t3125\t12\n" -"Let's make it 155, please.\n" -"155\t498\t311\t362\t3027\t12\n" -"Ah, let's try 157...\n" -"157\t501\t313\t362\t3066\t12\n" -"156?\n" -"156\t500\t312\t362\t3047\t12\n" -"That's it! Perfect! Thank you very much!\n" -"^D\n" -msgstr "" -"What size pinhole do I need for the focal length of 150?\n" -"150\t490\t306\t362\t2930\t12\n" -"Hmmm... How about 160?\n" -"160\t506\t316\t362\t3125\t12\n" -"Let's make it 155, please.\n" -"155\t498\t311\t362\t3027\t12\n" -"Ah, let's try 157...\n" -"157\t501\t313\t362\t3066\t12\n" -"156?\n" -"156\t500\t312\t362\t3047\t12\n" -"That's it! Perfect! Thank you very much!\n" -"^D\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4104 -msgid "" -"We have found that while for the focal length of 150, our pinhole diameter " -"should be 490 microns, or 0.49 mm, if we go with the almost identical focal " -"length of 156 mm, we can get away with a pinhole diameter of exactly one " -"half of a millimeter." -msgstr "" -"Мы выяснили, что при фокусном расстоянии 150 мм диаметр отверстия должен " -"составлять 490 микрон, или 0,49 мм, но если взять почти идентичное фокусное " -"расстояние 156 мм, можно использовать отверстие диаметром ровно половину " -"миллиметра." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4106 -#, no-wrap -msgid "Scripting" -msgstr "Скриптинг" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4109 -msgid "" -"Because we have chosen the `+#+` character to denote the start of a comment, " -"we can treat our pinhole software as a _scripting language_." -msgstr "" -"Поскольку мы выбрали символ `+#+` для обозначения начала комментария, мы " -"можем рассматривать наше программное обеспечение pinhole как _скриптовый " -"язык_." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4111 -msgid "You have probably seen shell _scripts_ that start with:" -msgstr "Вы, вероятно, видели _сценарии_ оболочки, которые начинаются с:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4115 -#, no-wrap -msgid "#! /bin/sh\n" -msgstr "#! /bin/sh\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4118 -msgid "...or..." -msgstr "...или..." - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4122 -#, no-wrap -msgid "#!/bin/sh\n" -msgstr "#!/bin/sh\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4125 -msgid "...because the blank space after the `#!` is optional." -msgstr "...потому что пробел после `#!` необязателен." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4128 -msgid "" -"Whenever UNIX(R) is asked to run an executable file which starts with the `#!" -"`, it assumes the file is a script. It adds the command to the rest of the " -"first line of the script, and tries to execute that." -msgstr "" -"Когда UNIX(R) получает запрос на выполнение исполняемого файла, который " -"начинается с `#!`, он предполагает, что это скрипт. Он добавляет команду к " -"остальной части первой строки скрипта и пытается выполнить её." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4130 -msgid "" -"Suppose now that we have installed pinhole in /usr/local/bin/, we can now " -"write a script to calculate various pinhole diameters suitable for various " -"focal lengths commonly used with the 120 film." -msgstr "" -"Предположим, что мы установили pinhole в /usr/local/bin/, теперь мы можем " -"написать скрипт для расчёта различных диаметров отверстий, подходящих для " -"различных фокусных расстояний, обычно используемых с плёнкой 120." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4132 -msgid "The script might look something like this:" -msgstr "Скрипт может выглядеть примерно так:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4138 -#, no-wrap -msgid "" -"#! /usr/local/bin/pinhole -b -i\n" -"# Find the best pinhole diameter\n" -"# for the 120 film\n" -msgstr "" -"#! /usr/local/bin/pinhole -b -i\n" -"# Find the best pinhole diameter\n" -"# for the 120 film\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4141 -#, no-wrap -msgid "" -"### Standard\n" -"80\n" -msgstr "" -"### Standard\n" -"80\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4144 -#, no-wrap -msgid "" -"### Wide angle\n" -"30, 40, 50, 60, 70\n" -msgstr "" -"### Wide angle\n" -"30, 40, 50, 60, 70\n" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4147 -#, no-wrap -msgid "" -"### Telephoto\n" -"100, 120, 140\n" -msgstr "" -"### Telephoto\n" -"100, 120, 140\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4150 -msgid "Because 120 is a medium size film, we may name this file medium." -msgstr "" -"Поскольку 120 — это плёнка среднего размера, мы можем назвать этот файл " -"`medium`." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4152 -msgid "" -"We can set its permissions to execute, and run it as if it were a program:" -msgstr "" -"Мы можем установить права на выполнение и запустить его, как если бы это " -"была программа:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4157 -#, no-wrap -msgid "" -"% chmod 755 medium\n" -"% ./medium\n" -msgstr "" -"% chmod 755 medium\n" -"% ./medium\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4160 -msgid "UNIX(R) will interpret that last command as:" -msgstr "UNIX(R) интерпретирует последнюю команду следующим образом:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4164 -#, no-wrap -msgid "% /usr/local/bin/pinhole -b -i ./medium\n" -msgstr "% /usr/local/bin/pinhole -b -i ./medium\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4167 -msgid "It will run that command and display:" -msgstr "Он выполнит эту команду и отобразит:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4179 -#, no-wrap -msgid "" -"80\t358\t224\t256\t1562\t11\n" -"30\t219\t137\t128\t586\t9\n" -"40\t253\t158\t181\t781\t10\n" -"50\t283\t177\t181\t977\t10\n" -"60\t310\t194\t181\t1172\t10\n" -"70\t335\t209\t181\t1367\t10\n" -"100\t400\t250\t256\t1953\t11\n" -"120\t438\t274\t256\t2344\t11\n" -"140\t473\t296\t256\t2734\t11\n" -msgstr "" -"80\t358\t224\t256\t1562\t11\n" -"30\t219\t137\t128\t586\t9\n" -"40\t253\t158\t181\t781\t10\n" -"50\t283\t177\t181\t977\t10\n" -"60\t310\t194\t181\t1172\t10\n" -"70\t335\t209\t181\t1367\t10\n" -"100\t400\t250\t256\t1953\t11\n" -"120\t438\t274\t256\t2344\t11\n" -"140\t473\t296\t256\t2734\t11\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4182 -msgid "Now, let us enter:" -msgstr "Теперь введем:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4186 -#, no-wrap -msgid "% ./medium -c\n" -msgstr "% ./medium -c\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4189 -msgid "UNIX(R) will treat that as:" -msgstr "UNIX(R) интерпретирует это следующим образом:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4193 -#, no-wrap -msgid "% /usr/local/bin/pinhole -b -i ./medium -c\n" -msgstr "% /usr/local/bin/pinhole -b -i ./medium -c\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4197 -msgid "" -"That gives it two conflicting options: `-b` and `-c` (Use Bender's constant " -"and use Connors' constant). We have programmed it so later options override " -"early ones-our program will calculate everything using Connors' constant:" -msgstr "" -"Это даёт ему два конфликтующих параметра: `-b` и `-c` (Использовать " -"константу Бендера и использовать константу Коннорса). Мы запрограммировали " -"его так, что более поздние параметры переопределяют ранние — наша программа " -"будет вычислять все, используя константу Коннорса:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4209 -#, no-wrap -msgid "" -"80\t331\t242\t256\t1826\t11\n" -"30\t203\t148\t128\t685\t9\n" -"40\t234\t171\t181\t913\t10\n" -"50\t262\t191\t181\t1141\t10\n" -"60\t287\t209\t181\t1370\t10\n" -"70\t310\t226\t256\t1598\t11\n" -"100\t370\t270\t256\t2283\t11\n" -"120\t405\t296\t256\t2739\t11\n" -"140\t438\t320\t362\t3196\t12\n" -msgstr "" -"80\t331\t242\t256\t1826\t11\n" -"30\t203\t148\t128\t685\t9\n" -"40\t234\t171\t181\t913\t10\n" -"50\t262\t191\t181\t1141\t10\n" -"60\t287\t209\t181\t1370\t10\n" -"70\t310\t226\t256\t1598\t11\n" -"100\t370\t270\t256\t2283\t11\n" -"120\t405\t296\t256\t2739\t11\n" -"140\t438\t320\t362\t3196\t12\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4213 -msgid "" -"We decide we want to go with Bender's constant after all. We want to save " -"its values as a comma-separated file:" -msgstr "" -"Мы решаем, что всё же выбираем константу Бендера. Мы хотим сохранить её " -"значения в виде файла с разделителями-запятыми:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4229 -#, no-wrap -msgid "" -"% ./medium -b -e > bender\n" -"% cat bender\n" -"focal length in millimeters,pinhole diameter in microns,F-number,normalized F-number,F-5.6 multiplier,stops from F-5.6\n" -"80,358,224,256,1562,11\n" -"30,219,137,128,586,9\n" -"40,253,158,181,781,10\n" -"50,283,177,181,977,10\n" -"60,310,194,181,1172,10\n" -"70,335,209,181,1367,10\n" -"100,400,250,256,1953,11\n" -"120,438,274,256,2344,11\n" -"140,473,296,256,2734,11\n" -"%\n" -msgstr "" -"% ./medium -b -e > bender\n" -"% cat bender\n" -"focal length in millimeters,pinhole diameter in microns,F-number,normalized F-number,F-5.6 multiplier,stops from F-5.6\n" -"80,358,224,256,1562,11\n" -"30,219,137,128,586,9\n" -"40,253,158,181,781,10\n" -"50,283,177,181,977,10\n" -"60,310,194,181,1172,10\n" -"70,335,209,181,1367,10\n" -"100,400,250,256,1953,11\n" -"120,438,274,256,2344,11\n" -"140,473,296,256,2734,11\n" -"%\n" - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4232 -#, no-wrap -msgid "Caveats" -msgstr "Предостережения" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4236 -msgid "" -"Assembly language programmers who \"grew up\" under MS-DOS(R) and Windows(R) " -"often tend to take shortcuts. Reading the keyboard scan codes and writing " -"directly to video memory are two classical examples of practices which, " -"under MS-DOS(R) are not frowned upon but considered the right thing to do." -msgstr "" -"Программисты на ассемблере, которые \"выросли\" на MS-DOS(R) и Windows(R), " -"часто склонны искать короткие пути. Чтение скан-кодов клавиатуры и запись " -"напрямую в видеопамять — это два классических примера подходов, которые в MS-" -"DOS(R) не только не порицаются, но и считаются правильными." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4238 -msgid "" -"The reason? Both the PC BIOS and MS-DOS(R) are notoriously slow when " -"performing these operations." -msgstr "" -"Причина? И BIOS ПК, и MS-DOS(R) печально известны своей медленной работой " -"при выполнении этих операций." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4241 -msgid "" -"You may be tempted to continue similar practices in the UNIX(R) " -"environment. For example, I have seen a web site which explains how to " -"access the keyboard scan codes on a popular UNIX(R) clone." -msgstr "" -"Вас может возникнуть соблазн продолжить подобные практики в среде UNIX(R). " -"Например, я видел веб-сайт, который объясняет, как получить доступ к скан-" -"кодам клавиатуры на популярном клоне UNIX(R)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4243 -msgid "" -"That is generally a _very bad idea_ in UNIX(R) environment! Let me explain " -"why." -msgstr "" -"Это, как правило, *очень плохая идея* в среде UNIX(R)! Позвольте объяснить " -"почему." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4245 -#, no-wrap -msgid "UNIX(R) Is Protected" -msgstr "UNIX(R) защищен" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4252 -msgid "" -"For one thing, it may simply not be possible. UNIX(R) runs in protected " -"mode. Only the kernel and device drivers are allowed to access hardware " -"directly. Perhaps a particular UNIX(R) clone will let you read the keyboard " -"scan codes, but chances are a real UNIX(R) operating system will not. And " -"even if one version may let you do it, the next one may not, so your " -"carefully crafted software may become a dinosaur overnight." -msgstr "" -"Прежде всего, это может быть просто невозможно. UNIX(R) работает в " -"защищённом режиме. Только ядро и драйверы устройств имеют прямой доступ к " -"аппаратному обеспечению. Возможно, какой-то конкретный клон UNIX(R) позволит " -"вам читать скан-коды клавиатуры, но скорее всего настоящая операционная " -"система UNIX(R) этого не допустит. И даже если одна версия разрешает это, " -"следующая может запретить, так что ваше тщательно разработанное программное " -"обеспечение может в одночасье устареть." - -#. type: Title === -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4254 -#, no-wrap -msgid "UNIX(R) Is an Abstraction" -msgstr "UNIX(R) — это работа с абстракциями" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4257 -msgid "" -"But there is a much more important reason not to try accessing the hardware " -"directly (unless, of course, you are writing a device driver), even on the " -"UNIX(R) like systems that let you do it:" -msgstr "" -"Но существует гораздо более важная причина не пытаться обращаться к " -"оборудованию напрямую (если, конечно, вы не пишете драйвер устройства), даже " -"в UNIX(R)-подобных системах, которые позволяют это делать:" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4259 -msgid "_UNIX(R) is an abstraction!_" -msgstr "_UNIX(R) — это работа с абстракциями!_" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4265 -msgid "" -"There is a major difference in the philosophy of design between MS-DOS(R) " -"and UNIX(R). MS-DOS(R) was designed as a single-user system. It is run on " -"a computer with a keyboard and a video screen attached directly to that " -"computer. User input is almost guaranteed to come from that keyboard. Your " -"program's output virtually always ends up on that screen." -msgstr "" -"Существует фундаментальное различие в философии проектирования между MS-" -"DOS(R) и UNIX(R). MS-DOS(R) разрабатывалась как однопользовательская " -"система. Она работает на компьютере, к которому напрямую подключены " -"клавиатура и монитор. Ввод пользователя практически гарантированно поступает " -"с этой клавиатуры. Вывод вашей программы почти всегда отображается на этом " -"экране." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4268 -msgid "" -"This is NEVER guaranteed under UNIX(R). It is quite common for a UNIX(R) " -"user to pipe and redirect program input and output:" -msgstr "" -"Это НИКОГДА не гарантируется в UNIX(R). Довольно часто пользователь UNIX(R) " -"перенаправляет ввод и вывод программы с помощью конвейеров и перенаправлений:" - -#. type: delimited block . 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4272 -#, no-wrap -msgid "% program1 | program2 | program3 > file1\n" -msgstr "% program1 | program2 | program3 > file1\n" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4276 -msgid "" -"If you have written program2, your input does not come from the keyboard but " -"from the output of program1. Similarly, your output does not go to the " -"screen but becomes the input for program3 whose output, in turn, goes to [." -"filename]#file1#." -msgstr "" -"Если вы написали program2, ваш ввод поступает не с клавиатуры, а из вывода " -"program1. Аналогично, ваш вывод не выводится на экран, а становится вводом " -"для program3, чей вывод, в свою очередь, отправляется в [.filename]#file1#." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4279 -msgid "" -"But there is more! Even if you made sure that your input comes from, and " -"your output goes to, the terminal, there is no guarantee the terminal is a " -"PC: It may not have its video memory where you expect it, nor may its " -"keyboard be producing PC-style scan codes. It may be a Macintosh(R), or any " -"other computer." -msgstr "" -"Но это ещё не все! Даже если вы убедились, что ваш ввод поступает с " -"терминала, а вывод отправляется на терминал, нет гарантии, что терминал " -"является ПК: его видеопамять может находиться не там, где вы ожидаете, а " -"клавиатура может генерировать не PC-совместимые скан-коды. Это может быть " -"Macintosh(R) или любой другой компьютер." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4281 -msgid "" -"Now you may be shaking your head: My software is in PC assembly language, " -"how can it run on a Macintosh(R)? But I did not say your software would be " -"running on a Macintosh(R), only that its terminal may be a Macintosh(R)." -msgstr "" -"Вот вы, возможно, покачаете головой: мое программное обеспечение написано на " -"языке ассемблера для ПК, как оно может работать на Macintosh(R)? Но я не " -"говорил, что ваше программное обеспечение будет работать на Macintosh(R), а " -"лишь что его терминалом может быть Macintosh(R)." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4285 -msgid "" -"Under UNIX(R), the terminal does not have to be directly attached to the " -"computer that runs your software, it can even be on another continent, or, " -"for that matter, on another planet. It is perfectly possible that a " -"Macintosh(R) user in Australia connects to a UNIX(R) system in North America " -"(or anywhere else) via telnet. The software then runs on one computer, " -"while the terminal is on a different computer: If you try to read the scan " -"codes, you will get the wrong input!" -msgstr "" -"В UNIX(R) терминал не обязательно должен быть напрямую подключён к " -"компьютеру, на котором работает ваше программное обеспечение — он может " -"находиться даже на другом континенте или, например, на другой планете. " -"Вполне возможно, что пользователь Macintosh(R) в Австралии подключается к " -"системе UNIX(R) в Северной Америке (или где-либо ещё) через telnet. " -"Программное обеспечение работает на одном компьютере, а терминал находится " -"на другом: если попытаться считать скан-коды, будут получены неверные данные!" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4288 -msgid "" -"Same holds true about any other hardware: A file you are reading may be on a " -"disk you have no direct access to. A camera you are reading images from may " -"be on a space shuttle, connected to you via satellites." -msgstr "" -"То же самое относится и к любому другому оборудованию: файл, который вы " -"читаете, может находиться на диске, к которому у вас нет прямого доступа. " -"Камера, с которой вы считываете изображения, может находиться на космическом " -"корабле, соединённом с вами через спутники." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4291 -msgid "" -"That is why under UNIX(R) you must never make any assumptions about where " -"your data is coming from and going to. Always let the system handle the " -"physical access to the hardware." -msgstr "" -"Вот почему в UNIX(R) никогда нельзя делать никаких предположений о том, " -"откуда поступают ваши данные и куда они направляются. Всегда позволяйте " -"системе управлять физическим доступом к оборудованию." - -#. type: delimited block = 4 -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4299 -msgid "" -"These are caveats, not absolute rules. Exceptions are possible. For " -"example, if a text editor has determined it is running on a local machine, " -"it may want to read the scan codes directly for improved control. I am not " -"mentioning these caveats to tell you what to do or what not to do, just to " -"make you aware of certain pitfalls that await you if you have just arrived " -"to UNIX(R) form MS-DOS(R). Of course, creative people often break rules, " -"and it is OK as long as they know they are breaking them and why." -msgstr "" -"Это предостережения, а не абсолютные правила. Возможны исключения. Например, " -"если текстовый редактор определил, что работает на локальной машине, он " -"может захотеть читать скан-коды напрямую для улучшенного управления. Я " -"упоминаю эти предостережения не для того, чтобы сказать вам, что делать или " -"чего не делать, а просто чтобы вы осознавали определённые подводные камни, " -"которые ждут вас, если вы только что перешли с MS-DOS(R) на UNIX(R). " -"Конечно, творческие люди часто нарушают правила, и это нормально, пока они " -"осознают, что нарушают их, и понимают почему." - -#. type: Title == -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4302 -#, no-wrap -msgid "Acknowledgements" -msgstr "Благодарности" - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4305 -msgid "" -"This tutorial would never have been possible without the help of many " -"experienced FreeBSD programmers from the {freebsd-hackers}, many of whom " -"have patiently answered my questions, and pointed me in the right direction " -"in my attempts to explore the inner workings of UNIX(R) system programming " -"in general and FreeBSD in particular." -msgstr "" -"Это руководство никогда бы не было создано без помощи многих опытных " -"программистов FreeBSD из {freebsd-hackers}, которые терпеливо отвечали на " -"мои вопросы и направляли меня в моих попытках изучить внутренние механизмы " -"программирования в системе UNIX(R) в целом и в FreeBSD в частности." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4308 -msgid "" -"Thomas M. Sommers opened the door for me . His https://web.archive.org/" -"web/20090914064615/http://www.codebreakers-journal.com/content/" -"view/262/27[How do I write \"Hello, world\" in FreeBSD assembler?] web page " -"was my first encounter with an example of assembly language programming " -"under FreeBSD." -msgstr "" -"Томас М. Соммерс открыл дверь для меня. Его https://web.archive.org/" -"web/20090914064615/http://www.codebreakers-journal.com/content/" -"view/262/27[Как написать \"Hello, world\" на ассемблере в FreeBSD?] веб-" -"страница стала моей первой встречей с примером программирования на " -"ассемблере под FreeBSD." - -#. type: Plain text -#: documentation/content/en/books/developers-handbook/x86/_index.adoc:4310 -msgid "" -"Jake Burkholder has kept the door open by willingly answering all of my " -"questions and supplying me with example assembly language source code." -msgstr "" -"Джейк Буркхолдер держал дверь открытой, охотно отвечая на все мои вопросы и " -"предоставляя примеры исходного кода на языке ассемблера." |