summaryrefslogtreecommitdiffstats
path: root/docs/JOURNAL_FILE_FORMAT.md
diff options
context:
space:
mode:
authorVito Caputo <vcaputo@pengaru.com>2020-11-17 22:23:00 +0100
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>2020-11-18 09:29:58 +0100
commite3500e9d21963d8a61cff71b94a73555c9d74129 (patch)
tree5473347ddbfc25578142463937b2871c88b5da50 /docs/JOURNAL_FILE_FORMAT.md
parentsd-device: drop unwanted newline in netlink message (diff)
downloadsystemd-e3500e9d21963d8a61cff71b94a73555c9d74129.tar.xz
systemd-e3500e9d21963d8a61cff71b94a73555c9d74129.zip
JOURNAL_FILE_FORMAT: fixup typos and punctuation
No significant changes
Diffstat (limited to 'docs/JOURNAL_FILE_FORMAT.md')
-rw-r--r--docs/JOURNAL_FILE_FORMAT.md14
1 files changed, 7 insertions, 7 deletions
diff --git a/docs/JOURNAL_FILE_FORMAT.md b/docs/JOURNAL_FILE_FORMAT.md
index e87a758026..3910669899 100644
--- a/docs/JOURNAL_FILE_FORMAT.md
+++ b/docs/JOURNAL_FILE_FORMAT.md
@@ -517,7 +517,7 @@ _packed_ struct HashTableObject {
```
The structure of both DATA_HASH_TABLE and FIELD_HASH_TABLE objects are
-identical. They implement a simple hash table, which each cell containing
+identical. They implement a simple hash table, with each cell containing
offsets to the head and tail of the singly linked list of the DATA and FIELD
objects, respectively. DATA's and FIELD's next_hash_offset field are used to
chain up the objects. Empty cells have both offsets set to 0.
@@ -651,15 +651,15 @@ look up the FIELD object and follow the chain of links to all DATA it includes.
### Writing
-When an entry is appended to the journal for each of its data fields the data
-hash table should be checked. If the data field does not yet exist in the file
-it should be appended and added to the data hash table. When a field data
-object is added the field hash table should be checked for the field name of
+When an entry is appended to the journal, for each of its data fields the data
+hash table should be checked. If the data field does not yet exist in the file,
+it should be appended and added to the data hash table. When a data field's data
+object is added, the field hash table should be checked for the field name of
the data field, and a field object be added if necessary. After all data fields
(and recursively all field names) of the new entry are appended and linked up
-in the hashtables the entry object should be appended and linked up too.
+in the hashtables, the entry object should be appended and linked up too.
-In regular intervals a tag object should be written if sealing is enabled (see
+At regular intervals a tag object should be written if sealing is enabled (see
above). Before the file is closed a tag should be written too, to seal it off.
Before writing an object, time and disk space limits should be checked and