Units
Translation components API.
See the Weblate's Web API documentation for detailed description of the API.
GET /api/translations/documentation/articlesrc-scripting_index/id/units/?format=api&page=2
{ "count": 177, "next": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/units/?format=api&page=3", "previous": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/units/?format=api", "results": [ { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "What changed in this example?" ], "previous_source": "", "target": [ "" ], "id_hash": -2104992892649646798, "content_hash": -2104992892649646798, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:263", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 55, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 5, "source_unit": "https://translate-dev.freebsd.org/api/units/381753/?format=api", "priority": 100, "id": 1390335, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=62c9901deae55532", "url": "https://translate-dev.freebsd.org/api/units/1390335/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.511343Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "➊ The variable `rcvar` specifies the name of the ON/OFF knob variable." ], "previous_source": "", "target": [ "" ], "id_hash": 496651994295815603, "content_hash": 496651994295815603, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:265", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 56, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 12, "source_unit": "https://translate-dev.freebsd.org/api/units/381755/?format=api", "priority": 100, "id": 1390336, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=86e4765b80fdcdb3", "url": "https://translate-dev.freebsd.org/api/units/1390336/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.514220Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "➋ Now `load_rc_config` is invoked earlier in the script, before any man:rc.conf[5] variables are accessed." ], "previous_source": "", "target": [ "" ], "id_hash": -8771880043263535440, "content_hash": -8771880043263535440, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:267", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 57, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 15, "source_unit": "https://translate-dev.freebsd.org/api/units/381757/?format=api", "priority": 100, "id": 1390337, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=0644059378f056b0", "url": "https://translate-dev.freebsd.org/api/units/1390337/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.517177Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "While examining [.filename]#rc.d# scripts, keep in mind that man:sh[1] defers the evaluation of expressions in a function until the latter is called. Therefore it is not an error to invoke `load_rc_config` as late as just before `run_rc_command` and still access man:rc.conf[5] variables from the method functions exported to `run_rc_command`. This is because the method functions are to be called by `run_rc_command`, which is invoked _after_ `load_rc_config`." ], "previous_source": "", "target": [ "" ], "id_hash": 4233901618529474697, "content_hash": 4233901618529474697, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:273", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 58, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 66, "source_unit": "https://translate-dev.freebsd.org/api/units/611654/?format=api", "priority": 100, "id": 1390338, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=bac1d71702669889", "url": "https://translate-dev.freebsd.org/api/units/1390338/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.520322Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "➌ A warning will be emitted by `run_rc_command` if `rcvar` itself is set, but the indicated knob variable is unset. If your [.filename]#rc.d# script is for the base system, you should add a default setting for the knob to [.filename]#/etc/defaults/rc.conf# and document it in man:rc.conf[5]. Otherwise it is your script that should provide a default setting for the knob. The canonical approach to the latter case is shown in the example." ], "previous_source": "", "target": [ "" ], "id_hash": -856836263315381427, "content_hash": -856836263315381427, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:279", "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": 71, "source_unit": "https://translate-dev.freebsd.org/api/units/611656/?format=api", "priority": 100, "id": 1390339, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=741be7f54e69e34d", "url": "https://translate-dev.freebsd.org/api/units/1390339/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.524532Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "You can make man:rc.subr[8] act as though the knob is set to `ON`, irrespective of its current setting, by prefixing the argument to the script with `one` or `force`, as in `onestart` or `forcestop`. Keep in mind though that `force` has other dangerous effects we will touch upon below, while `one` just overrides the ON/OFF knob. E.g., assume that `dummy_enable` is `OFF`. The following command will run the `start` method in spite of the setting:" ], "previous_source": "", "target": [ "" ], "id_hash": 2137394567639081328, "content_hash": 2137394567639081328, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:286", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 60, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 75, "source_unit": "https://translate-dev.freebsd.org/api/units/611658/?format=api", "priority": 100, "id": 1390340, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=9da98d08ecfa2170", "url": "https://translate-dev.freebsd.org/api/units/1390340/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.552325Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "# /etc/rc.d/dummy onestart\n" ], "previous_source": "", "target": [ "" ], "id_hash": 9101981481088273168, "content_hash": 9101981481088273168, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:290", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 61, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 3, "source_unit": "https://translate-dev.freebsd.org/api/units/381765/?format=api", "priority": 100, "id": 1390341, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=fe50bbeec4734b10", "url": "https://translate-dev.freebsd.org/api/units/1390341/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.556654Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "➍ Now the message to be shown at boot time is no longer hard-coded in the script. It is specified by an man:rc.conf[5] variable named `dummy_msg`. This is a trivial example of how man:rc.conf[5] variables can control an [.filename]#rc.d# script." ], "previous_source": "", "target": [ "" ], "id_hash": -4114527790951083825, "content_hash": -4114527790951083825, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:297", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 62, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 40, "source_unit": "https://translate-dev.freebsd.org/api/units/611660/?format=api", "priority": 100, "id": 1390342, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=46e642c619e350cf", "url": "https://translate-dev.freebsd.org/api/units/1390342/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.564481Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "The names of all man:rc.conf[5] variables used exclusively by our script _must_ have the same prefix: `${name}_`. For example: `dummy_mode`, `dummy_state_file`, and so on." ], "previous_source": "", "target": [ "" ], "id_hash": -6358360952876814111, "content_hash": -6358360952876814111, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:302", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 63, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 24, "source_unit": "https://translate-dev.freebsd.org/api/units/611662/?format=api", "priority": 100, "id": 1390343, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=27c29066c21030e1", "url": "https://translate-dev.freebsd.org/api/units/1390343/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.569457Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "While it is possible to use a shorter name internally, e.g., just `msg`, adding the unique prefix `${name}_` to all global names introduced by our script will save us from possible collisions with the man:rc.subr[8] namespace." ], "previous_source": "", "target": [ "" ], "id_hash": -4713024967582227797, "content_hash": -4713024967582227797, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:307", "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": 36, "source_unit": "https://translate-dev.freebsd.org/api/units/381771/?format=api", "priority": 100, "id": 1390344, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=3e97f8c33db6e2ab", "url": "https://translate-dev.freebsd.org/api/units/1390344/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.573344Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "As a rule, [.filename]#rc.d# scripts of the base system need not provide defaults for their man:rc.conf[5] variables because the defaults should be set in [.filename]#/etc/defaults/rc.conf# instead. On the other hand, [.filename]#rc.d# scripts for ports should provide the defaults as shown in the example." ], "previous_source": "", "target": [ "" ], "id_hash": -6266388236322921747, "content_hash": -6266388236322921747, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:310", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 65, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 43, "source_unit": "https://translate-dev.freebsd.org/api/units/611664/?format=api", "priority": 100, "id": 1390345, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=290951198d4922ed", "url": "https://translate-dev.freebsd.org/api/units/1390345/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.579641Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "➎ Here we use `dummy_msg` to actually control our script, i.e., to emit a variable message. Use of a shell function is overkill here, since it only runs a single command; an equally valid alternative is:" ], "previous_source": "", "target": [ "" ], "id_hash": 5092710331220643991, "content_hash": 5092710331220643991, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:314", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 66, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 36, "source_unit": "https://translate-dev.freebsd.org/api/units/611666/?format=api", "priority": 100, "id": 1390346, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=c6acf1105c5e5097", "url": "https://translate-dev.freebsd.org/api/units/1390346/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.583784Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "start_cmd=\"echo \\\"$dummy_msg\\\"\"\n" ], "previous_source": "", "target": [ "" ], "id_hash": -4879638794249510958, "content_hash": -4879638794249510958, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:318", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 67, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 2, "source_unit": "https://translate-dev.freebsd.org/api/units/381777/?format=api", "priority": 100, "id": 1390347, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=3c480a5ebc8adfd2", "url": "https://translate-dev.freebsd.org/api/units/1390347/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.588173Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "Startup and shutdown of a simple daemon" ], "previous_source": "", "target": [ "" ], "id_hash": -8444834757010602763, "content_hash": -8444834757010602763, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:321", "context": "", "note": "type: Title ==", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 68, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 7, "source_unit": "https://translate-dev.freebsd.org/api/units/381779/?format=api", "priority": 100, "id": 1390348, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=0acdeb87f982c4f5", "url": "https://translate-dev.freebsd.org/api/units/1390348/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.592426Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "We said earlier that man:rc.subr[8] could provide default methods. Obviously, such defaults cannot be too general. They are suited for the common case of starting and shutting down a simple daemon program. Let us assume now that we need to write an [.filename]#rc.d# script for such a daemon called `mumbled`. Here it is:" ], "previous_source": "", "target": [ "" ], "id_hash": -102297669182269444, "content_hash": -102297669182269444, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:328", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 69, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 53, "source_unit": "https://translate-dev.freebsd.org/api/units/611668/?format=api", "priority": 100, "id": 1390349, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=7e9490cfd70a57fc", "url": "https://translate-dev.freebsd.org/api/units/1390349/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.596408Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "name=mumbled\nrcvar=mumbled_enable\n" ], "previous_source": "", "target": [ "" ], "id_hash": 4515639132769989598, "content_hash": 4515639132769989598, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:337, documentation/content/en/articles/rc-scripting/_index.adoc:394, documentation/content/en/articles/rc-scripting/_index.adoc:631", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 70, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 2, "source_unit": "https://translate-dev.freebsd.org/api/units/381783/?format=api", "priority": 100, "id": 1390350, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=beaac5ddca9bb3de", "url": "https://translate-dev.freebsd.org/api/units/1390350/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.600020Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "command=\"/usr/sbin/${name}\" <.>\n" ], "previous_source": "", "target": [ "" ], "id_hash": -3841581752012277924, "content_hash": -3841581752012277924, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:339", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 71, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 2, "source_unit": "https://translate-dev.freebsd.org/api/units/381785/?format=api", "priority": 100, "id": 1390351, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=4aaff5c007af775c", "url": "https://translate-dev.freebsd.org/api/units/1390351/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.603564Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "load_rc_config $name\nrun_rc_command \"$1\"\n" ], "previous_source": "", "target": [ "" ], "id_hash": 6382436172851742169, "content_hash": 6382436172851742169, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:342, documentation/content/en/articles/rc-scripting/_index.adoc:440, documentation/content/en/articles/rc-scripting/_index.adoc:646", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 72, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 4, "source_unit": "https://translate-dev.freebsd.org/api/units/381787/?format=api", "priority": 100, "id": 1390352, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=d892f7e2346e85d9", "url": "https://translate-dev.freebsd.org/api/units/1390352/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.607398Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "Pleasingly simple, isn't it? Let us examine our little script. The only new thing to note is as follows:" ], "previous_source": "", "target": [ "" ], "id_hash": 1974913651866216342, "content_hash": 1974913651866216342, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:346", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 73, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 19, "source_unit": "https://translate-dev.freebsd.org/api/units/611670/?format=api", "priority": 100, "id": 1390353, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=9b684d80b98e2796", "url": "https://translate-dev.freebsd.org/api/units/1390353/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.611196Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "➊ The `command` variable is meaningful to man:rc.subr[8]. If it is set, man:rc.subr[8] will act according to the scenario of serving a conventional daemon. In particular, the default methods will be provided for such arguments: `start`, `stop`, `restart`, `poll`, and `status`." ], "previous_source": "", "target": [ "" ], "id_hash": 4016835583505088507, "content_hash": 4016835583505088507, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:350", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 74, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 41, "source_unit": "https://translate-dev.freebsd.org/api/units/611672/?format=api", "priority": 100, "id": 1390354, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=b7beaaae5bf83ffb", "url": "https://translate-dev.freebsd.org/api/units/1390354/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.614526Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "The daemon will be started by running `$command` with command-line flags specified by `$mumbled_flags`. Thus all the input data for the default `start` method are available in the variables set by our script. Unlike `start`, other methods may require additional information about the process started. For instance, `stop` must know the PID of the process to terminate it. In the present case, man:rc.subr[8] will scan through the list of all processes, looking for a process with its name equal to `procname`. The latter is another variable of meaning to man:rc.subr[8], and its value defaults to that of `command`. In other words, when we set `command`, `procname` is effectively set to the same value. This enables our script to kill the daemon and to check if it is running in the first place." ], "previous_source": "", "target": [ "" ], "id_hash": 5724626787326806927, "content_hash": 5724626787326806927, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:359", "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": 132, "source_unit": "https://translate-dev.freebsd.org/api/units/611674/?format=api", "priority": 100, "id": 1390355, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=cf71f5bb924ccb8f", "url": "https://translate-dev.freebsd.org/api/units/1390355/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.618254Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "Some programs are in fact executable scripts. The system runs such a script by starting its interpreter and passing the name of the script to it as a command-line argument. This is reflected in the list of processes, which can confuse man:rc.subr[8]. You should additionally set `command_interpreter` to let man:rc.subr[8] know the actual name of the process if `$command` is a script." ], "previous_source": "", "target": [ "" ], "id_hash": 2935602006806855500, "content_hash": 2935602006806855500, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:366", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 76, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 62, "source_unit": "https://translate-dev.freebsd.org/api/units/611676/?format=api", "priority": 100, "id": 1390356, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=a8bd5a78c1a57f4c", "url": "https://translate-dev.freebsd.org/api/units/1390356/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.621679Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "For each [.filename]#rc.d# script, there is an optional man:rc.conf[5] variable that takes precedence over `command`. Its name is constructed as follows: `${name}_program`, where `name` is the mandatory variable we discussed <<name-var, earlier>>. E.g., in this case it will be `mumbled_program`. It is man:rc.subr[8] that arranges `${name}_program` to override `command`." ], "previous_source": "", "target": [ "" ], "id_hash": 4909219808122753901, "content_hash": 4909219808122753901, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:371", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 77, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 49, "source_unit": "https://translate-dev.freebsd.org/api/units/611678/?format=api", "priority": 100, "id": 1390357, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=c4210d67c377d36d", "url": "https://translate-dev.freebsd.org/api/units/1390357/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.624760Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "Of course, man:sh[1] will permit you to set `${name}_program` from man:rc.conf[5] or the script itself even if `command` is unset. In that case, the special properties of `${name}_program` are lost, and it becomes an ordinary variable your script can use for its own purposes. However, the sole use of `${name}_program` is discouraged because using it together with `command` became an idiom of [.filename]#rc.d# scripting." ], "previous_source": "", "target": [ "" ], "id_hash": -7473704153715555564, "content_hash": -7473704153715555564, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:375", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 78, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 64, "source_unit": "https://translate-dev.freebsd.org/api/units/611680/?format=api", "priority": 100, "id": 1390358, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=184811ab696c4314", "url": "https://translate-dev.freebsd.org/api/units/1390358/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.628413Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "For more detailed information on default methods, refer to man:rc.subr[8]." ], "previous_source": "", "target": [ "" ], "id_hash": 2327000880037653551, "content_hash": 2327000880037653551, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:378", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 79, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 10, "source_unit": "https://translate-dev.freebsd.org/api/units/381801/?format=api", "priority": 100, "id": 1390359, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=a04b2af8aeaa6c2f", "url": "https://translate-dev.freebsd.org/api/units/1390359/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.659589Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "Startup and shutdown of an advanced daemon" ], "previous_source": "", "target": [ "" ], "id_hash": 3818684683030145373, "content_hash": 3818684683030145373, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:380", "context": "", "note": "type: Title ==", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 80, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 7, "source_unit": "https://translate-dev.freebsd.org/api/units/381803/?format=api", "priority": 100, "id": 1390360, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=b4feb17ca93ca95d", "url": "https://translate-dev.freebsd.org/api/units/1390360/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.663302Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "Let us add some meat onto the bones of the previous script and make it more complex and featureful. The default methods can do a good job for us, but we may need some of their aspects tweaked. Now we will learn how to tune the default methods to our needs." ], "previous_source": "", "target": [ "" ], "id_hash": 1130593541803541715, "content_hash": 1130593541803541715, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:385", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 81, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 51, "source_unit": "https://translate-dev.freebsd.org/api/units/611682/?format=api", "priority": 100, "id": 1390361, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=8fb0acd60c8d04d3", "url": "https://translate-dev.freebsd.org/api/units/1390361/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.666693Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "command=\"/usr/sbin/${name}\"\ncommand_args=\"mock arguments > /dev/null 2>&1\" <.>\n" ], "previous_source": "", "target": [ "" ], "id_hash": -8598356115260950638, "content_hash": -8598356115260950638, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:397", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 82, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 7, "source_unit": "https://translate-dev.freebsd.org/api/units/381807/?format=api", "priority": 100, "id": 1390362, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=08ac80ab51903792", "url": "https://translate-dev.freebsd.org/api/units/1390362/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.670550Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "pidfile=\"/var/run/${name}.pid\" <.>\n" ], "previous_source": "", "target": [ "" ], "id_hash": 6094019581354149631, "content_hash": 6094019581354149631, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:399", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 83, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 2, "source_unit": "https://translate-dev.freebsd.org/api/units/381809/?format=api", "priority": 100, "id": 1390363, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=d4924e8590e386ff", "url": "https://translate-dev.freebsd.org/api/units/1390363/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.674285Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "required_files=\"/etc/${name}.conf /usr/share/misc/${name}.rules\" <.>\n" ], "previous_source": "", "target": [ "" ], "id_hash": -9123729460911910134, "content_hash": -9123729460911910134, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:401", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 84, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 3, "source_unit": "https://translate-dev.freebsd.org/api/units/426404/?format=api", "priority": 100, "id": 1390364, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=016200651794530a", "url": "https://translate-dev.freebsd.org/api/units/1390364/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.682865Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "sig_reload=\"USR1\" <.>\n" ], "previous_source": "", "target": [ "" ], "id_hash": 5377256183437142996, "content_hash": 5377256183437142996, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:403", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 85, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 2, "source_unit": "https://translate-dev.freebsd.org/api/units/381813/?format=api", "priority": 100, "id": 1390365, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=ca9fda02480b2bd4", "url": "https://translate-dev.freebsd.org/api/units/1390365/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.688615Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "start_precmd=\"${name}_prestart\" <.>\nstop_postcmd=\"echo Bye-bye\" <.>\n" ], "previous_source": "", "target": [ "" ], "id_hash": 162566234966995330, "content_hash": 162566234966995330, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:406", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 86, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 5, "source_unit": "https://translate-dev.freebsd.org/api/units/381815/?format=api", "priority": 100, "id": 1390366, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=82418d211fae3182", "url": "https://translate-dev.freebsd.org/api/units/1390366/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.692852Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "extra_commands=\"reload plugh xyzzy\" <.>\n" ], "previous_source": "", "target": [ "" ], "id_hash": 3423542704392687662, "content_hash": 3423542704392687662, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:408", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 87, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 4, "source_unit": "https://translate-dev.freebsd.org/api/units/381817/?format=api", "priority": 100, "id": 1390367, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=af82ddf370b4d02e", "url": "https://translate-dev.freebsd.org/api/units/1390367/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.696944Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "plugh_cmd=\"mumbled_plugh\" <.>\nxyzzy_cmd=\"echo 'Nothing happens.'\"\n" ], "previous_source": "", "target": [ "" ], "id_hash": -3676198038201779156, "content_hash": -3676198038201779156, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:411", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 88, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 5, "source_unit": "https://translate-dev.freebsd.org/api/units/381819/?format=api", "priority": 100, "id": 1390368, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=4cfb855c90febc2c", "url": "https://translate-dev.freebsd.org/api/units/1390368/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.702581Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "mumbled_prestart()\n{\n\tif checkyesno mumbled_smart; then <.>\n\t\trc_flags=\"-o smart ${rc_flags}\" <.>\n\tfi\n\tcase \"$mumbled_mode\" in\n\tfoo)\n\t\trc_flags=\"-frotz ${rc_flags}\"\n\t\t;;\n\tbar)\n\t\trc_flags=\"-baz ${rc_flags}\"\n\t\t;;\n\t*)\n\t\twarn \"Invalid value for mumbled_mode\" <.>\n\t\treturn 1 <.>\n\t\t;;\n\tesac\n\trun_rc_command xyzzy <.>\n\treturn 0\n}\n" ], "previous_source": "", "target": [ "" ], "id_hash": -6349807941781058009, "content_hash": -6349807941781058009, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:432", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 89, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 41, "source_unit": "https://translate-dev.freebsd.org/api/units/381821/?format=api", "priority": 100, "id": 1390369, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=27e0f351d62f8e27", "url": "https://translate-dev.freebsd.org/api/units/1390369/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.707990Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "mumbled_plugh() <.>\n{\n\techo 'A hollow voice says \"plugh\".'\n}\n" ], "previous_source": "", "target": [ "" ], "id_hash": 4579986197697268865, "content_hash": 4579986197697268865, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:437", "context": "", "note": "type: delimited block . 4", "flags": "no-wrap", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 90, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 10, "source_unit": "https://translate-dev.freebsd.org/api/units/381823/?format=api", "priority": 100, "id": 1390370, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=bf8f612e55f00c81", "url": "https://translate-dev.freebsd.org/api/units/1390370/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.712045Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "➊ Additional arguments to `$command` can be passed in `command_args`. They will be added to the command line after `$mumbled_flags`. Since the final command line is passed to `eval` for its actual execution, input and output redirections can be specified in `command_args`." ], "previous_source": "", "target": [ "" ], "id_hash": -6925910391368904281, "content_hash": -6925910391368904281, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:445", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 91, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 42, "source_unit": "https://translate-dev.freebsd.org/api/units/611684/?format=api", "priority": 100, "id": 1390371, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=1fe23931b04511a7", "url": "https://translate-dev.freebsd.org/api/units/1390371/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.715191Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "_Never_ include dashed options, like `-X` or `--foo`, in `command_args`. The contents of `command_args` will appear at the end of the final command line, hence they are likely to follow arguments present in `${name}_flags`; but most commands will not recognize dashed options after ordinary arguments. A better way of passing additional options to `$command` is to add them to the beginning of `${name}_flags`. Another way is to modify `rc_flags` <<rc-flags, as shown later>>." ], "previous_source": "", "target": [ "" ], "id_hash": -2509864996234396364, "content_hash": -2509864996234396364, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:452", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 92, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 73, "source_unit": "https://translate-dev.freebsd.org/api/units/611686/?format=api", "priority": 100, "id": 1390372, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=5d2b2b157142fd34", "url": "https://translate-dev.freebsd.org/api/units/1390372/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.718831Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "➋ A good-mannered daemon should create a _pidfile_ so that its process can be found more easily and reliably. The variable `pidfile`, if set, tells man:rc.subr[8] where it can find the pidfile for its default methods to use." ], "previous_source": "", "target": [ "" ], "id_hash": 8616415718089284157, "content_hash": 8616415718089284157, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:456", "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": 38, "source_unit": "https://translate-dev.freebsd.org/api/units/611688/?format=api", "priority": 100, "id": 1390373, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=f793a871a1cdda3d", "url": "https://translate-dev.freebsd.org/api/units/1390373/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.722587Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "In fact, man:rc.subr[8] will also use the pidfile to see if the daemon is already running before starting it. This check can be skipped by using the `faststart` argument." ], "previous_source": "", "target": [ "" ], "id_hash": -7259887125407860862, "content_hash": -7259887125407860862, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:461", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 94, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 29, "source_unit": "https://translate-dev.freebsd.org/api/units/611690/?format=api", "priority": 100, "id": 1390374, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=1b3fb31fbca1f782", "url": "https://translate-dev.freebsd.org/api/units/1390374/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.725588Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "➌ If the daemon cannot run unless certain files exist, just list them in `required_files`, and man:rc.subr[8] will check that those files do exist before starting the daemon. There also are `required_dirs` and `required_vars` for directories and environment variables, respectively. They all are described in detail in man:rc.subr[8]." ], "previous_source": "", "target": [ "" ], "id_hash": -2139329414384356624, "content_hash": -2139329414384356624, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:466", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 95, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 48, "source_unit": "https://translate-dev.freebsd.org/api/units/611692/?format=api", "priority": 100, "id": 1390375, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=624f933b761372f0", "url": "https://translate-dev.freebsd.org/api/units/1390375/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.728825Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "The default method from man:rc.subr[8] can be forced to skip the prerequisite checks by using `forcestart` as the argument to the script." ], "previous_source": "", "target": [ "" ], "id_hash": -947789817444566699, "content_hash": -947789817444566699, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:470", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 96, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 22, "source_unit": "https://translate-dev.freebsd.org/api/units/381835/?format=api", "priority": 100, "id": 1390376, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=72d8c62ec17bf955", "url": "https://translate-dev.freebsd.org/api/units/1390376/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.731957Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "➍ We can customize signals to send to the daemon in case they differ from the well-known ones. In particular, `sig_reload` specifies the signal that makes the daemon reload its configuration; it is SIGHUP by default. Another signal is sent to stop the daemon process; the default is SIGTERM, but this can be changed by setting `sig_stop` appropriately." ], "previous_source": "", "target": [ "" ], "id_hash": 8171040012650328274, "content_hash": 8171040012650328274, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:476", "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": 58, "source_unit": "https://translate-dev.freebsd.org/api/units/611694/?format=api", "priority": 100, "id": 1390377, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=f1655d997786b0d2", "url": "https://translate-dev.freebsd.org/api/units/1390377/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.753965Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "The signal names should be specified to man:rc.subr[8] without the `SIG` prefix, as it is shown in the example. The FreeBSD version of man:kill[1] can recognize the `SIG` prefix, but the versions from other OS types may not." ], "previous_source": "", "target": [ "" ], "id_hash": 4832131965543838077, "content_hash": 4832131965543838077, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:481", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 98, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 38, "source_unit": "https://translate-dev.freebsd.org/api/units/611696/?format=api", "priority": 100, "id": 1390378, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=c30f2e6bc20cf17d", "url": "https://translate-dev.freebsd.org/api/units/1390378/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.764120Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "➎➏ Performing additional tasks before or after the default methods is easy. For each command-argument supported by our script, we can define `argument_precmd` and `argument_postcmd`. These man:sh[1] commands are invoked before and after the respective method, as it is evident from their names." ], "previous_source": "", "target": [ "" ], "id_hash": -7450827251323861345, "content_hash": -7450827251323861345, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:486", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 99, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 43, "source_unit": "https://translate-dev.freebsd.org/api/units/611698/?format=api", "priority": 100, "id": 1390379, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=18995817520a869f", "url": "https://translate-dev.freebsd.org/api/units/1390379/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.775031Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "Overriding a default method with a custom `argument_cmd` still does not prevent us from making use of `argument_precmd` or `argument_postcmd` if we need to. In particular, the former is good for checking custom, sophisticated conditions that should be met before performing the command itself. Using `argument_precmd` along with `argument_cmd` lets us logically separate the checks from the action." ], "previous_source": "", "target": [ "" ], "id_hash": 1904391641481687103, "content_hash": 1904391641481687103, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:492", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 100, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 58, "source_unit": "https://translate-dev.freebsd.org/api/units/611700/?format=api", "priority": 100, "id": 1390380, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=9a6dc21ba7bd303f", "url": "https://translate-dev.freebsd.org/api/units/1390380/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.784789Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "Do not forget that you can cram any valid man:sh[1] expressions into the methods, pre-, and post-commands you define. Just invoking a function that makes the real job is a good style in most cases, but never let style limit your understanding of what is going on behind the curtain." ], "previous_source": "", "target": [ "" ], "id_hash": -1729651640916647919, "content_hash": -1729651640916647919, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:495", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 101, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 50, "source_unit": "https://translate-dev.freebsd.org/api/units/611702/?format=api", "priority": 100, "id": 1390381, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=67ff0aff25fde011", "url": "https://translate-dev.freebsd.org/api/units/1390381/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.790070Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "➐ If we would like to implement custom arguments, which can also be thought of as _commands_ to our script, we need to list them in `extra_commands` and provide methods to handle them." ], "previous_source": "", "target": [ "" ], "id_hash": 7815018544659277433, "content_hash": 7815018544659277433, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:498", "context": "", "note": "type: Plain text", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 102, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 33, "source_unit": "https://translate-dev.freebsd.org/api/units/381847/?format=api", "priority": 100, "id": 1390382, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=ec7485f5eb81a679", "url": "https://translate-dev.freebsd.org/api/units/1390382/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.794157Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "The `reload` command is special. On the one hand, it has a preset method in man:rc.subr[8]. On the other hand, `reload` is not offered by default. The reason is that not all daemons use the same reload mechanism and some have nothing to reload at all. So we need to ask explicitly that the builtin functionality be provided. We can do so via `extra_commands`." ], "previous_source": "", "target": [ "" ], "id_hash": 1369455018728398926, "content_hash": 1369455018728398926, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:506", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 103, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 64, "source_unit": "https://translate-dev.freebsd.org/api/units/611704/?format=api", "priority": 100, "id": 1390383, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=93014815772ea04e", "url": "https://translate-dev.freebsd.org/api/units/1390383/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.797603Z" }, { "translation": "https://translate-dev.freebsd.org/api/translations/documentation/articlesrc-scripting_index/id/?format=api", "source": [ "What do we get from the default method for `reload`? Quite often daemons reload their configuration upon reception of a signal - typically, SIGHUP. Therefore man:rc.subr[8] attempts to reload the daemon by sending a signal to it. The signal is preset to SIGHUP but can be customized via `sig_reload` if necessary." ], "previous_source": "", "target": [ "" ], "id_hash": 2358757484686172100, "content_hash": 2358757484686172100, "location": "documentation/content/en/articles/rc-scripting/_index.adoc:510", "context": "", "note": "type: delimited block = 4", "flags": "", "labels": [], "state": 0, "fuzzy": false, "translated": false, "approved": false, "position": 104, "has_suggestion": false, "has_comment": false, "has_failing_check": false, "num_words": 51, "source_unit": "https://translate-dev.freebsd.org/api/units/611706/?format=api", "priority": 100, "id": 1390384, "web_url": "https://translate-dev.freebsd.org/translate/documentation/articlesrc-scripting_index/id/?checksum=a0bbfd6f62035fc4", "url": "https://translate-dev.freebsd.org/api/units/1390384/?format=api", "explanation": "", "extra_flags": "", "pending": false, "timestamp": "2022-03-09T17:03:27.801277Z" } ] }