diff options
Diffstat (limited to 'documentation/content/en/articles/gjournal-desktop')
| -rw-r--r-- | documentation/content/en/articles/gjournal-desktop/_index.adoc | 12 | ||||
| -rw-r--r-- | documentation/content/en/articles/gjournal-desktop/_index.po | 62 |
2 files changed, 38 insertions, 36 deletions
diff --git a/documentation/content/en/articles/gjournal-desktop/_index.adoc b/documentation/content/en/articles/gjournal-desktop/_index.adoc index 1f8c15f843..164c92985b 100644 --- a/documentation/content/en/articles/gjournal-desktop/_index.adoc +++ b/documentation/content/en/articles/gjournal-desktop/_index.adoc @@ -61,7 +61,7 @@ On rare occasions, file system corruption reaches a point where user interventio The new journaling capability provided by GEOM can greatly assist in such scenarios, by virtually eliminating the time required for file system checking, and ensuring that the file system is quickly restored to a consistent state. -This article describes a procedure for implementing UFS journaling on a typical desktop PC scenario (one hard disk used for both operating system and data). +This article describes a procedure for implementing UFS journaling on a typical desktop PC scenario (one hard disk used for both operating system and data). It should be followed during a fresh installation of FreeBSD. The steps are simple enough and do not require overly complex interaction with the command line. @@ -106,14 +106,14 @@ For example: * You reserved some free disk space in a partition in [.filename]#/dev/ad0s1g#. * Using `gjournal`, a new [.filename]#/dev/ad0s1f.journal# device is created where [.filename]#/dev/ad0s1f# is the data provider, and [.filename]#/dev/ad0s1g# is the journal provider. This new device is then used for all subsequent file operations. -The amount of disk space you need to reserve for the journal provider depends on the usage load of the file system and not on the size of the data provider. +The amount of disk space you need to reserve for the journal provider depends on the usage load of the file system and not on the size of the data provider. For example on a typical office desktop, a 1 GB journal provider for the [.filename]#/usr# file system will suffice, while a machine that deals with heavy disk I/O (i.e. video editing) may need more. A kernel panic will occur if the journal space is exhausted before it has a chance to be committed. [NOTE] ==== The journal sizes suggested here, are highly unlikely to cause problems in typical desktop use (such as web browsing, word processing and playback of media files). -If your workload includes intense disk activity, use the following rule for maximum reliability: Your RAM size should fit in 30% of the journal provider's space. +If your workload includes intense disk activity, use the following rule for maximum reliability: Your RAM size should fit in 30% of the journal provider's space. For example, if your system has 1 GB RAM, create an approximately 3.3 GB journal provider. (Multiply your RAM size with 3.3 to obtain the size of the journal). ==== @@ -197,7 +197,7 @@ We would however suggest you postpone installation of third party software (pack [[first-boot]] === Booting for the first time -Your system will come up normally, but you will need to edit [.filename]#/etc/fstab# and remove the extra swap partitions you created for the journals. +Your system will come up normally, but you will need to edit [.filename]#/etc/fstab# and remove the extra swap partitions you created for the journals. Normally, the swap partition you will actually use is the one with the "b" suffix (i.e. ad0s1b in our example). Remove all other swap space entries and reboot so that FreeBSD will stop using them. @@ -371,7 +371,7 @@ options UFS_GJOURNAL # Note: This is already in GENERIC options GEOM_JOURNAL # You will have to add this one .... -Rebuild and reinstall your kernel following the relevant extref:{handbook}[instructions in the FreeBSD Handbook., kernelconfig] +Rebuild and reinstall your kernel following the relevant extref:{handbook}kernelconfig[instructions in the FreeBSD Handbook., kernelconfig] Do not forget to remove the relevant "load" entry from [.filename]#/boot/loader.conf# if you have previously used it. @@ -504,7 +504,7 @@ Finally, edit [.filename]#/boot/loader.conf#, remove the entry that loads the `g Journaling is a fairly new feature of FreeBSD, and as such, it is not very well documented yet. You may however find the following additional references useful: -* A extref:{handbook}[new section on journaling, geom-gjournal] is now part of the FreeBSD Handbook. +* A extref:{handbook}geom[new section on journaling, geom-gjournal] is now part of the FreeBSD Handbook. * https://lists.freebsd.org/pipermail/freebsd-current/2006-June/064043.html[This post] in {freebsd-current} by man:gjournal[8]'s developer, `{pjd}`. * https://lists.freebsd.org/pipermail/freebsd-questions/2008-April/173501.html[This post] in {freebsd-questions} by `{ivoras}`. * The manual pages of man:gjournal[8] and man:geom[8]. diff --git a/documentation/content/en/articles/gjournal-desktop/_index.po b/documentation/content/en/articles/gjournal-desktop/_index.po index 260c965b75..44f42646d0 100644 --- a/documentation/content/en/articles/gjournal-desktop/_index.po +++ b/documentation/content/en/articles/gjournal-desktop/_index.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: FreeBSD Documentation VERSION\n" -"POT-Creation-Date: 2024-12-29 08:30-0500\n" +"POT-Creation-Date: 2025-11-08 16:17+0000\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -190,8 +190,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/gjournal-desktop/_index.adoc:106 msgid "" -"You wish to journal your [.filename]#/usr# file system, stored in [." -"filename]#/dev/ad0s1f# (which already contains data)." +"You wish to journal your [.filename]#/usr# file system, stored in " +"[.filename]#/dev/ad0s1f# (which already contains data)." msgstr "" #. type: Plain text @@ -236,8 +236,8 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/gjournal-desktop/_index.adoc:122 msgid "" -"For more information about journaling, please read the manual page of man:" -"gjournal[8]." +"For more information about journaling, please read the manual page of " +"man:gjournal[8]." msgstr "" #. type: Title == @@ -291,8 +291,8 @@ msgstr "" #: documentation/content/en/articles/gjournal-desktop/_index.adoc:142 msgid "" "If this is more or less what you need, it is very easy to adjust for " -"journaling. Simply use the arrow keys to move the highlight to the [." -"filename]#/usr# partition and press kbd:[D] to delete it." +"journaling. Simply use the arrow keys to move the highlight to the " +"[.filename]#/usr# partition and press kbd:[D] to delete it." msgstr "" #. type: Plain text @@ -310,10 +310,10 @@ msgstr "" #: documentation/content/en/articles/gjournal-desktop/_index.adoc:152 msgid "" "Should you journal the [.filename]#/var# partition? Normally, journaling " -"makes sense on quite large partitions. You may decide not to journal [." -"filename]#/var#, although doing so on a typical desktop will cause no harm. " -"If the file system is lightly used (quite probable for a desktop) you may " -"wish to allocate less disk space for its journal." +"makes sense on quite large partitions. You may decide not to journal " +"[.filename]#/var#, although doing so on a typical desktop will cause no " +"harm. If the file system is lightly used (quite probable for a desktop) you " +"may wish to allocate less disk space for its journal." msgstr "" #. type: delimited block = 4 @@ -494,8 +494,8 @@ msgstr "" #: documentation/content/en/articles/gjournal-desktop/_index.adoc:222 msgid "" "Press kbd:[Enter] to get the default shell. We will need to unmount the " -"partitions that will be journaled, in our example [.filename]#/usr# and [." -"filename]#/var#:" +"partitions that will be journaled, in our example [.filename]#/usr# and " +"[.filename]#/var#:" msgstr "" #. type: delimited block . 4 @@ -522,8 +522,8 @@ msgstr "" msgid "" "Now, use your notes to determine which partition will be used for each " "journal. In our example, [.filename]#/usr# is [.filename]#ad0s1f# and its " -"journal will be [.filename]#ad0s1g#, while [.filename]#/var# is [." -"filename]#ad0s1d# and will be journaled to [.filename]#ad0s1h#. The " +"journal will be [.filename]#ad0s1g#, while [.filename]#/var# is " +"[.filename]#ad0s1d# and will be journaled to [.filename]#ad0s1h#. The " "following commands are required:" msgstr "" @@ -569,10 +569,11 @@ msgstr "" #. type: delimited block = 4 #: documentation/content/en/articles/gjournal-desktop/_index.adoc:266 msgid "" -"At this point, two new devices are created, namely [.filename]#ad0s1d." -"journal# and [.filename]#ad0s1f.journal#. These represent the [.filename]#/" -"var# and [.filename]#/usr# partitions we have to mount. Before mounting, we " -"must however set the journal flag on them and clear the Soft Updates flag:" +"At this point, two new devices are created, namely " +"[.filename]#ad0s1d.journal# and [.filename]#ad0s1f.journal#. These " +"represent the [.filename]#/var# and [.filename]#/usr# partitions we have to " +"mount. Before mounting, we must however set the journal flag on them and " +"clear the Soft Updates flag:" msgstr "" #. type: delimited block . 4 @@ -769,7 +770,7 @@ msgstr "" #: documentation/content/en/articles/gjournal-desktop/_index.adoc:375 msgid "" "Rebuild and reinstall your kernel following the relevant extref:{handbook}" -"[instructions in the FreeBSD Handbook., kernelconfig]" +"kernelconfig[instructions in the FreeBSD Handbook., kernelconfig]" msgstr "" #. type: Plain text @@ -818,10 +819,10 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/gjournal-desktop/_index.adoc:396 msgid "" -"You either forgot (or misspelled) the entry in [.filename]#/boot/loader." -"conf#, or there are errors in your [.filename]#/etc/fstab# file. These are " -"usually easy to fix. Press kbd:[Enter] to get to the default single user " -"shell. Then locate the root of the problem:" +"You either forgot (or misspelled) the entry in [.filename]#/boot/" +"loader.conf#, or there are errors in your [.filename]#/etc/fstab# file. " +"These are usually easy to fix. Press kbd:[Enter] to get to the default " +"single user shell. Then locate the root of the problem:" msgstr "" #. type: delimited block . 4 @@ -1005,22 +1006,23 @@ msgstr "" #. type: Plain text #: documentation/content/en/articles/gjournal-desktop/_index.adoc:508 msgid "" -"A extref:{handbook}[new section on journaling, geom-gjournal] is now part of " -"the FreeBSD Handbook." +"A extref:{handbook}geom[new section on journaling, geom-gjournal] is now " +"part of the FreeBSD Handbook." msgstr "" #. type: Plain text #: documentation/content/en/articles/gjournal-desktop/_index.adoc:509 msgid "" -"https://lists.freebsd.org/pipermail/freebsd-current/2006-June/064043." -"html[This post] in {freebsd-current} by man:gjournal[8]'s developer, `{pjd}`." +"https://lists.freebsd.org/pipermail/freebsd-current/2006-June/" +"064043.html[This post] in {freebsd-current} by man:gjournal[8]'s developer, " +"`{pjd}`." msgstr "" #. type: Plain text #: documentation/content/en/articles/gjournal-desktop/_index.adoc:510 msgid "" -"https://lists.freebsd.org/pipermail/freebsd-questions/2008-April/173501." -"html[This post] in {freebsd-questions} by `{ivoras}`." +"https://lists.freebsd.org/pipermail/freebsd-questions/2008-April/" +"173501.html[This post] in {freebsd-questions} by `{ivoras}`." msgstr "" #. type: Plain text |