Units
Translation components API.
See the Weblate's Web API documentation for detailed description of the API.
GET /api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/units/?format=api&page=5
{ "count": 273, "next": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/units/?format=api&page=6", "previous": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/units/?format=api&page=4", "results": [ { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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." ], "previous_source": "", "target": [ "" ], "id_hash": -8618678428203007064, "content_hash": -8618678428203007064, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:222", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 54, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 25, "source_unit": "https://translate-dev.freebsd.org/api/units/1188104/?format=api", "priority": 100, "id": 1189076, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=08644da21da343a8", "url": "https://translate-dev.freebsd.org/api/units/1189076/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:47.659402Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "The one function used by both, clients and servers, is man:socket[2]. It is declared this way:" ], "previous_source": "", "target": [ "" ], "id_hash": -4192973922514383958, "content_hash": -4192973922514383958, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:236", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 59, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 16, "source_unit": "https://translate-dev.freebsd.org/api/units/1188106/?format=api", "priority": 100, "id": 1189077, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=45cf906ecc0dcbaa", "url": "https://translate-dev.freebsd.org/api/units/1189077/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:47.770524Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 what allows sockets to be treated the same way as files." ], "previous_source": "", "target": [ "" ], "id_hash": -1258178716956050908, "content_hash": -1258178716956050908, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:245", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 61, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 40, "source_unit": "https://translate-dev.freebsd.org/api/units/1188108/?format=api", "priority": 100, "id": 1189078, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=6e8a0d1f7fe0ba24", "url": "https://translate-dev.freebsd.org/api/units/1189078/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:47.854359Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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. They are declared in [.filename]#sys/socket.h#." ], "previous_source": "", "target": [ "" ], "id_hash": -7018387873453463288, "content_hash": -7018387873453463288, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:249", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 62, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 31, "source_unit": "https://translate-dev.freebsd.org/api/units/1188110/?format=api", "priority": 100, "id": 1189079, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=1e99ad6a02e5a908", "url": "https://translate-dev.freebsd.org/api/units/1189079/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:47.861021Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 `SOCK_STREAM`, which tells the system you are asking for a _reliable stream delivery service_ (which is TCP when used with `PF_INET`)." ], "previous_source": "", "target": [ "" ], "id_hash": -210741916757095300, "content_hash": -210741916757095300, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:255", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 64, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 43, "source_unit": "https://translate-dev.freebsd.org/api/units/1188112/?format=api", "priority": 100, "id": 1189080, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=7d134b57e0688c7c", "url": "https://translate-dev.freebsd.org/api/units/1189080/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:47.873654Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "Finally, the `protocol` argument depends on the previous two arguments, and is not always meaningful. In that case, use `0` for its value." ], "previous_source": "", "target": [ "" ], "id_hash": -3378154664278670028, "content_hash": -3378154664278670028, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:262", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 67, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 23, "source_unit": "https://translate-dev.freebsd.org/api/units/1188114/?format=api", "priority": 100, "id": 1189081, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=511e623b27574534", "url": "https://translate-dev.freebsd.org/api/units/1189081/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:47.961132Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "Nowhere, in the `socket` function have we specified to what other system we should be connected. Our newly created socket remains _unconnected_." ], "previous_source": "", "target": [ "" ], "id_hash": -3091316545387563772, "content_hash": -3091316545387563772, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:268", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 69, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 22, "source_unit": "https://translate-dev.freebsd.org/api/units/1188116/?format=api", "priority": 100, "id": 1189082, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=55196ffaffe2f504", "url": "https://translate-dev.freebsd.org/api/units/1189082/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:47.973484Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 to answer if the phone rings." ], "previous_source": "", "target": [ "" ], "id_hash": -5541977599143491469, "content_hash": -5541977599143491469, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:271", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 70, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 36, "source_unit": "https://translate-dev.freebsd.org/api/units/1188118/?format=api", "priority": 100, "id": 1189083, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=3316f0bc79e14873", "url": "https://translate-dev.freebsd.org/api/units/1189083/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:48.052551Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 declarations in the [.filename]#sys/socket.h# refer to it as `struct sockaddr`. This structure is declared in the same file:" ], "previous_source": "", "target": [ "" ], "id_hash": -7801672314705913836, "content_hash": -7801672314705913836, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:279", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 72, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 44, "source_unit": "https://translate-dev.freebsd.org/api/units/1188120/?format=api", "priority": 100, "id": 1189084, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=13bae45d63f45814", "url": "https://translate-dev.freebsd.org/api/units/1189084/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:48.069017Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "This vagueness is quite deliberate. Sockets is a very powerful interface. While most people perhaps think of it as nothing more than the Internet interface-and most applications probably use it for that nowadays-sockets can be used for just about _any_ kind of interprocess communications, of which the Internet (or, more precisely, IP) is only one." ], "previous_source": "", "target": [ "" ], "id_hash": -2541750494708070467, "content_hash": -2541750494708070467, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:299", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 75, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 55, "source_unit": "https://translate-dev.freebsd.org/api/units/1188122/?format=api", "priority": 100, "id": 1189085, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=5cb9e3644f4087bd", "url": "https://translate-dev.freebsd.org/api/units/1189085/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:48.160094Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "The one used for IP is AF_INET. It is a symbol for the constant `2`." ], "previous_source": "", "target": [ "" ], "id_hash": -5325770978824991836, "content_hash": -5325770978824991836, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:355", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 78, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 15, "source_unit": "https://translate-dev.freebsd.org/api/units/1188124/?format=api", "priority": 100, "id": 1189086, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=36170f830c0d4ba4", "url": "https://translate-dev.freebsd.org/api/units/1189086/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:48.254672Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 write a text string representing the current date and time to port 13. We want to use TCP/IP, so we need to specify `AF_INET` in the address family field. `AF_INET` is defined as `2`. Let us use the IP address of `192.43.244.18`, which is the time server of US federal government (`time.nist.gov`)." ], "previous_source": "", "target": [ "" ], "id_hash": 1725016056658835967, "content_hash": 1725016056658835967, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:386", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 86, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 81, "source_unit": "https://translate-dev.freebsd.org/api/units/1188126/?format=api", "priority": 100, "id": 1189087, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=97f07cf6c8feb9ff", "url": "https://translate-dev.freebsd.org/api/units/1189087/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:48.454443Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 bytes. Similarly, it stores 32-bit integers as a sequence of 4 bytes." ], "previous_source": "", "target": [ "" ], "id_hash": 5872936694502656551, "content_hash": 5872936694502656551, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:409", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 93, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 39, "source_unit": "https://translate-dev.freebsd.org/api/units/1188128/?format=api", "priority": 100, "id": 1189088, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=d180dcceb8300a27", "url": "https://translate-dev.freebsd.org/api/units/1189088/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:48.567259Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "Well, that depends, of course. On a Pentium(R), or other x86, based computer, it would look like this:" ], "previous_source": "", "target": [ "" ], "id_hash": 3137722078797349664, "content_hash": 3137722078797349664, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:423", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 97, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 18, "source_unit": "https://translate-dev.freebsd.org/api/units/1188130/?format=api", "priority": 100, "id": 1189089, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=ab8b6d9b369dc320", "url": "https://translate-dev.freebsd.org/api/units/1189089/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:48.660845Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "And on a PDP it might look different yet. But the above two are the most common ways in use today." ], "previous_source": "", "target": [ "" ], "id_hash": 1372888676006735985, "content_hash": 1372888676006735985, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:434", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 103, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 21, "source_unit": "https://translate-dev.freebsd.org/api/units/1188132/?format=api", "priority": 100, "id": 1189090, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=930d7afa1989b071", "url": "https://translate-dev.freebsd.org/api/units/1189090/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:48.848864Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "Ordinarily, wanting to write portable code, programmers pretend that these differences do not exist. And they get away with it (except when they code in assembly language). Alas, you cannot get away with it that easily when coding for sockets." ], "previous_source": "", "target": [ "" ], "id_hash": 1539542094343076808, "content_hash": 1539542094343076808, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:438", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 104, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 40, "source_unit": "https://translate-dev.freebsd.org/api/units/1188134/?format=api", "priority": 100, "id": 1189091, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=955d8d60c2147bc8", "url": "https://translate-dev.freebsd.org/api/units/1189091/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:48.858448Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "While that answer may surprise you at first, remember that the general sockets interface only understands the `sa_len` and `sa_family` fields of the `sockaddr` structure. You do not have to worry about the byte order there (of course, on FreeBSD `sa_family` is only 1 byte anyway, but many other UNIX(R) systems do not have `sa_len` and use 2 bytes for `sa_family`, and expect the data in whatever order is native to the computer)." ], "previous_source": "", "target": [ "" ], "id_hash": 7731902428246844872, "content_hash": 7731902428246844872, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:449", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 109, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 73, "source_unit": "https://translate-dev.freebsd.org/api/units/1188136/?format=api", "priority": 100, "id": 1189092, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=eb4d3c4b09a225c8", "url": "https://translate-dev.freebsd.org/api/units/1189092/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:49.058230Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 destination." ], "previous_source": "", "target": [ "" ], "id_hash": -951246576278581333, "content_hash": -951246576278581333, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:452", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 110, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 27, "source_unit": "https://translate-dev.freebsd.org/api/units/1188138/?format=api", "priority": 100, "id": 1189093, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=72cc7e475f1bcfab", "url": "https://translate-dev.freebsd.org/api/units/1189093/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:49.071074Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 server, we read the port number so we know what service the other computer is expecting from us. Either way, sockets only has to forward the port number as data. It does not interpret it in any way." ], "previous_source": "", "target": [ "" ], "id_hash": -6137307750077606312, "content_hash": -6137307750077606312, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:457", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 111, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 66, "source_unit": "https://translate-dev.freebsd.org/api/units/1188140/?format=api", "priority": 100, "id": 1189094, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=2ad3e71e3f5f5658", "url": "https://translate-dev.freebsd.org/api/units/1189094/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:49.160937Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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." ], "previous_source": "", "target": [ "" ], "id_hash": 5256751339012275931, "content_hash": 5256751339012275931, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:460", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 112, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 25, "source_unit": "https://translate-dev.freebsd.org/api/units/1188142/?format=api", "priority": 100, "id": 1189095, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=c8f3bb7dca62bedb", "url": "https://translate-dev.freebsd.org/api/units/1189095/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:49.168128Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 order_." ], "previous_source": "", "target": [ "" ], "id_hash": 9059697828718055609, "content_hash": 9059697828718055609, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:467", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 115, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 28, "source_unit": "https://translate-dev.freebsd.org/api/units/1188144/?format=api", "priority": 100, "id": 1189096, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=fdba832cc51e10b9", "url": "https://translate-dev.freebsd.org/api/units/1189096/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:49.255443Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "We have several ways of dealing with it. One would be to _reverse_ the values in our code:" ], "previous_source": "", "target": [ "" ], "id_hash": 5128770987338748900, "content_hash": 5128770987338748900, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:482", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 121, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 18, "source_unit": "https://translate-dev.freebsd.org/api/units/1188146/?format=api", "priority": 100, "id": 1189097, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=c72d0e0a22a7d3e4", "url": "https://translate-dev.freebsd.org/api/units/1189097/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:49.449914Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 programming in assembly language). In most cases, however, it can cause a problem." ], "previous_source": "", "target": [ "" ], "id_hash": 1984981822238373929, "content_hash": 1984981822238373929, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:493", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 123, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 40, "source_unit": "https://translate-dev.freebsd.org/api/units/1188148/?format=api", "priority": 100, "id": 1189098, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=9b8c127350203829", "url": "https://translate-dev.freebsd.org/api/units/1189098/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:49.550654Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 them to the _network byte order_. It works well." ], "previous_source": "", "target": [ "" ], "id_hash": -7741274145409941500, "content_hash": -7741274145409941500, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:497", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 124, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 37, "source_unit": "https://translate-dev.freebsd.org/api/units/1188150/?format=api", "priority": 100, "id": 1189099, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=1491782e05ecc004", "url": "https://translate-dev.freebsd.org/api/units/1189099/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:49.558961Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 order_. You need to recompile all your software. All of your software continues to perform well, except the one program you wrote." ], "previous_source": "", "target": [ "" ], "id_hash": 9029060411413660894, "content_hash": 9029060411413660894, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:502", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 125, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 49, "source_unit": "https://translate-dev.freebsd.org/api/units/1188152/?format=api", "priority": 100, "id": 1189100, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=fd4daa9b2dda84de", "url": "https://translate-dev.freebsd.org/api/units/1189100/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:49.568085Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 hair, calling the names of all gods you ever heard of (and some you made up), hitting your monitor with a nerf bat, and performing all the other traditional ceremonies of trying to figure out why something that has worked so well is suddenly not working at all." ], "previous_source": "", "target": [ "" ], "id_hash": -4468518014717551197, "content_hash": -4468518014717551197, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:506", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 126, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 75, "source_unit": "https://translate-dev.freebsd.org/api/units/1188154/?format=api", "priority": 100, "id": 1189101, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=41fca28a74539da3", "url": "https://translate-dev.freebsd.org/api/units/1189101/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:49.666533Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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` and `long` respectively from the _host byte order_ to the _network byte order_, and the man:ntohs[3] and man:ntohl[3] C functions to go the other way." ], "previous_source": "", "target": [ "" ], "id_hash": -6722886691248811704, "content_hash": -6722886691248811704, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:511", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 128, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 50, "source_unit": "https://translate-dev.freebsd.org/api/units/1188156/?format=api", "priority": 100, "id": 1189102, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=22b3822c76e9d148", "url": "https://translate-dev.freebsd.org/api/units/1189102/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:49.763104Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "On _MSB-first_ systems these functions do nothing. On _LSB-first_ systems they convert values to the proper order." ], "previous_source": "", "target": [ "" ], "id_hash": -2326121714046837158, "content_hash": -2326121714046837158, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:514", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 129, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 17, "source_unit": "https://translate-dev.freebsd.org/api/units/1188158/?format=api", "priority": 100, "id": 1189103, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=5fb7f4a019ea5e5a", "url": "https://translate-dev.freebsd.org/api/units/1189103/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:49.770009Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 knows the _port_ the server resides at. It is akin to you picking up the phone and dialing the number (the _address_), then, after someone answers, asking for the person in charge of wingdings (the _port_)." ], "previous_source": "", "target": [ "" ], "id_hash": 7957233628301780190, "content_hash": 7957233628301780190, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:523", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 132, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 62, "source_unit": "https://translate-dev.freebsd.org/api/units/1188160/?format=api", "priority": 100, "id": 1189104, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=ee6dc5d361b864de", "url": "https://translate-dev.freebsd.org/api/units/1189104/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:49.949594Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 talked about extensively. Finally, `namelen` informs the system how many bytes are in our `sockaddr` structure." ], "previous_source": "", "target": [ "" ], "id_hash": -1808222706811875151, "content_hash": -1808222706811875151, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:537", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 136, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 41, "source_unit": "https://translate-dev.freebsd.org/api/units/1188162/?format=api", "priority": 100, "id": 1189105, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=66e7e7074daed0b1", "url": "https://translate-dev.freebsd.org/api/units/1189105/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:50.049967Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "If `connect` is successful, it returns `0`. Otherwise it returns `-1` and stores the error code in `errno`." ], "previous_source": "", "target": [ "" ], "id_hash": 505183515603262002, "content_hash": 505183515603262002, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:540", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 137, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 18, "source_unit": "https://translate-dev.freebsd.org/api/units/1188164/?format=api", "priority": 100, "id": 1189106, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=8702c5bb19ea5a32", "url": "https://translate-dev.freebsd.org/api/units/1189106/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:50.057498Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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, or just too busy, or it may not have a server listening at the specified port. Or it may outright _refuse_ any request for specific code." ], "previous_source": "", "target": [ "" ], "id_hash": -5624350319812727005, "content_hash": -5624350319812727005, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:544", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 138, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 54, "source_unit": "https://translate-dev.freebsd.org/api/units/1188166/?format=api", "priority": 100, "id": 1189107, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=31f24b2ee7352f23", "url": "https://translate-dev.freebsd.org/api/units/1189107/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:50.066577Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "In this case, the date was June 19, 2001, the time was 02:29:25 UTC. Naturally, your results will vary." ], "previous_source": "", "target": [ "" ], "id_hash": -5016632912767757026, "content_hash": -5016632912767757026, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:607", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 151, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 19, "source_unit": "https://translate-dev.freebsd.org/api/units/1188168/?format=api", "priority": 100, "id": 1189108, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=3a6156f1f1f1d51e", "url": "https://translate-dev.freebsd.org/api/units/1189108/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:50.559962Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 will call, nor how many clients will call. It may be just sitting there, waiting patiently, one moment, The next moment, it can find itself swamped with requests from a number of clients, all calling in at the same time." ], "previous_source": "", "target": [ "" ], "id_hash": 1103928558615587008, "content_hash": 1103928558615587008, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:615", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 153, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 67, "source_unit": "https://translate-dev.freebsd.org/api/units/1188170/?format=api", "priority": 100, "id": 1189109, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=8f51f12cd9b0e8c0", "url": "https://translate-dev.freebsd.org/api/units/1189109/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:50.649745Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 are now at work and available to answer the phone at a specific extension. We use man:bind[2] to tell sockets which port we want to serve." ], "previous_source": "", "target": [ "" ], "id_hash": -5720818071778675370, "content_hash": -5720818071778675370, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:626", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 157, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 55, "source_unit": "https://translate-dev.freebsd.org/api/units/1188172/?format=api", "priority": 100, "id": 1189110, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=309b92461eff3556", "url": "https://translate-dev.freebsd.org/api/units/1189110/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:50.671496Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "Beside specifying the port in `addr`, the server may include its IP address. However, it can just use the symbolic constant INADDR_ANY to indicate it will serve all requests to the specified port regardless of what its IP address is. This symbol, along with several similar ones, is declared in [.filename]#netinet/in.h#" ], "previous_source": "", "target": [ "" ], "id_hash": -1258940930724427038, "content_hash": -1258940930724427038, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:635", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 159, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 51, "source_unit": "https://translate-dev.freebsd.org/api/units/1188174/?format=api", "priority": 100, "id": 1189111, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=6e8757e4c6f88ae2", "url": "https://translate-dev.freebsd.org/api/units/1189111/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:50.757429Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 this:" ], "previous_source": "", "target": [ "" ], "id_hash": 8747741940564264440, "content_hash": 8747741940564264440, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:644", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 161, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 25, "source_unit": "https://translate-dev.freebsd.org/api/units/1188176/?format=api", "priority": 100, "id": 1189112, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=f96638f28a1e85f8", "url": "https://translate-dev.freebsd.org/api/units/1189112/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:50.769755Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 make sure your own phone is plugged in and the ringer is turned on. Plus, you make sure your call waiting is activated, so you can hear the phone ring even while you are talking to someone." ], "previous_source": "", "target": [ "" ], "id_hash": 6681040222687939250, "content_hash": 6681040222687939250, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:653", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 165, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 64, "source_unit": "https://translate-dev.freebsd.org/api/units/1188178/?format=api", "priority": 100, "id": 1189113, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=dcb7d2af53694ab2", "url": "https://translate-dev.freebsd.org/api/units/1189113/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:50.957996Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 determines the maximum size of the queue of pending connections." ], "previous_source": "", "target": [ "" ], "id_hash": 5433235973493848423, "content_hash": 5433235973493848423, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:663", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 168, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 35, "source_unit": "https://translate-dev.freebsd.org/api/units/1188180/?format=api", "priority": 100, "id": 1189114, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=cb66bb54d4f97967", "url": "https://translate-dev.freebsd.org/api/units/1189114/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:50.976860Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "After you hear the phone ringing, you accept the call by answering the call. You have now established a connection with your client. This connection remains active until either you or your client hang up." ], "previous_source": "", "target": [ "" ], "id_hash": -7844648068795096188, "content_hash": -7844648068795096188, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:670", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 170, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 35, "source_unit": "https://translate-dev.freebsd.org/api/units/1188182/?format=api", "priority": 100, "id": 1189115, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=13223624e783a384", "url": "https://translate-dev.freebsd.org/api/units/1189115/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:51.065575Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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` structure." ], "previous_source": "", "target": [ "" ], "id_hash": 1737738933098696710, "content_hash": 1737738933098696710, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:680", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 173, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 26, "source_unit": "https://translate-dev.freebsd.org/api/units/1188184/?format=api", "priority": 100, "id": 1189116, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=981db05a4bb6d006", "url": "https://translate-dev.freebsd.org/api/units/1189116/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:51.155897Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "The return value is an integer. Indeed, the `accept` returns a _new socket_. You will use this new socket to communicate with the client." ], "previous_source": "", "target": [ "" ], "id_hash": -2512743916765496054, "content_hash": -2512743916765496054, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:684", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 174, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 24, "source_unit": "https://translate-dev.freebsd.org/api/units/1188186/?format=api", "priority": 100, "id": 1189117, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=5d20f0b885ab3d0a", "url": "https://translate-dev.freebsd.org/api/units/1189117/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:51.164740Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "Now, the new socket is meant only for communications. It is fully connected. We cannot pass it to `listen` again, trying to accept additional connections." ], "previous_source": "", "target": [ "" ], "id_hash": -3228353886045847834, "content_hash": -3228353886045847834, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:690", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 176, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 25, "source_unit": "https://translate-dev.freebsd.org/api/units/1188188/?format=api", "priority": 100, "id": 1189118, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=5332953ec4fc3ee6", "url": "https://translate-dev.freebsd.org/api/units/1189118/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:51.254082Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 program invoked it)." ], "previous_source": "", "target": [ "" ], "id_hash": 6511459652222992788, "content_hash": 6511459652222992788, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:699", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 179, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 29, "source_unit": "https://translate-dev.freebsd.org/api/units/1188190/?format=api", "priority": 100, "id": 1189119, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=da5d5a0df40a4194", "url": "https://translate-dev.freebsd.org/api/units/1189119/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:51.269056Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "We start by creating a socket. Then we fill out the `sockaddr_in` structure in `sa`. Note the conditional use of INADDR_ANY:" ], "previous_source": "", "target": [ "" ], "id_hash": -5246141926286863731, "content_hash": -5246141926286863731, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:797", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 198, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 21, "source_unit": "https://translate-dev.freebsd.org/api/units/1188192/?format=api", "priority": 100, "id": 1189120, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=3731f5b69a63528d", "url": "https://translate-dev.freebsd.org/api/units/1189120/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:51.768689Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "Its value is `0`. Since we have just used `bzero` on the entire structure, it would be redundant to set it to `0` again. But if we port our code to some other system where INADDR_ANY is perhaps not a zero, we need to assign it to `sa.sin_addr.s_addr`. Most modern C compilers are clever enough to notice that INADDR_ANY is a constant. As long as it is a zero, they will optimize the entire conditional statement out of the code." ], "previous_source": "", "target": [ "" ], "id_hash": 7122302228745966793, "content_hash": 7122302228745966793, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:809", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 200, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 80, "source_unit": "https://translate-dev.freebsd.org/api/units/1188194/?format=api", "priority": 100, "id": 1189121, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=e2d78024376054c9", "url": "https://translate-dev.freebsd.org/api/units/1189121/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:51.852496Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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, the `s` variable is our socket. The parent process will not need it, so it calls `close`, then it returns `0` to inform its own parent it had terminated successfully." ], "previous_source": "", "target": [ "" ], "id_hash": 1079304388316002695, "content_hash": 1079304388316002695, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:813", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 201, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 58, "source_unit": "https://translate-dev.freebsd.org/api/units/1188196/?format=api", "priority": 100, "id": 1189122, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=8efa759f6e187987", "url": "https://translate-dev.freebsd.org/api/units/1189122/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:51.862983Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 because _daytime_ is not a protocol many clients request all the time, and because it can process each request instantly anyway." ], "previous_source": "", "target": [ "" ], "id_hash": 4975221893500147439, "content_hash": 4975221893500147439, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:818", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 202, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 47, "source_unit": "https://translate-dev.freebsd.org/api/units/1188198/?format=api", "priority": 100, "id": 1189123, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=c50b89f3c8d296ef", "url": "https://translate-dev.freebsd.org/api/units/1189123/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:51.870547Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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_ server. This is only possible whenever there is no real \"conversation\" going on between the client and the server: As soon as the server detects a connection to the client, it sends out some data and closes the connection. The entire operation may take nanoseconds, and it is finished." ], "previous_source": "", "target": [ "" ], "id_hash": -7423216966594651509, "content_hash": -7423216966594651509, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:835", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 210, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 75, "source_unit": "https://translate-dev.freebsd.org/api/units/1188200/?format=api", "priority": 100, "id": 1189124, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=18fb6f7faf791a8b", "url": "https://translate-dev.freebsd.org/api/units/1189124/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:52.156309Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/booksdevelopers-handbooksockets_index/zh_CN/?format=api", "source": [ "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 the program to set up any `signal` handlers, open any files we may need, etc." ], "previous_source": "", "target": [ "" ], "id_hash": -8143141055767178893, "content_hash": -8143141055767178893, "location": "documentation/content/en/books/developers-handbook/sockets/_index.adoc:842", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 212, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 44, "source_unit": "https://translate-dev.freebsd.org/api/units/1188202/?format=api", "priority": 100, "id": 1189125, "web_url": "https://translate-dev.freebsd.org/translate/documentation/booksdevelopers-handbooksockets_index/zh_CN/?checksum=0efdc05a9f191173", "url": "https://translate-dev.freebsd.org/api/units/1189125/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2021-06-08T11:12:52.167781Z" } ] }