Skip to content

Commit 9afd43f

Browse files
authored
Initial rustdocs (#67)
1 parent d876bf5 commit 9afd43f

15 files changed

+181
-86
lines changed

.changes/unreleased/Added-20250225-004526.yaml

Lines changed: 0 additions & 3 deletions
This file was deleted.

.changes/unreleased/Changed-20250224-233352.yaml

Lines changed: 0 additions & 3 deletions
This file was deleted.

.changes/unreleased/Changed-20250224-233435.yaml

Lines changed: 0 additions & 3 deletions
This file was deleted.

.changes/unreleased/Changed-20250225-231102.yaml

Lines changed: 0 additions & 3 deletions
This file was deleted.

.changes/unreleased/Changed-20250226-233732.yaml

Lines changed: 0 additions & 3 deletions
This file was deleted.

.changes/unreleased/Changed-20250226-233803.yaml

Lines changed: 0 additions & 3 deletions
This file was deleted.

.changes/v0.2.0.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
## v0.2.0 - 2025-03-30
2+
### Added
3+
* Support for parsing StateDump Protobuf data
4+
### Changed
5+
* Updated dependencies and migrated to Rust 2024 edition
6+
* Made log_type and event_type enums
7+
* Improved handling of log number data marked as private
8+
* Moved to HashMap instead of Vec for UUIDText and dsc parsing
9+
* Only keep a small cache of UUID strings instead of all strings. Should reduce memory usage quite a bit

CHANGELOG.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,4 +6,12 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
66
and is generated by [Changie](https://github.com/miniscruff/changie).
77

88

9-
No releases yet, this file will be updated when generating your first release.
9+
## v0.2.0 - 2025-03-30
10+
### Added
11+
* Support for parsing StateDump Protobuf data
12+
### Changed
13+
* Updated dependencies and migrated to Rust 2024 edition
14+
* Made log_type and event_type enums
15+
* Improved handling of log number data marked as private
16+
* Moved to HashMap instead of Vec for UUIDText and dsc parsing
17+
* Only keep a small cache of UUID strings instead of all strings. Should reduce memory usage quite a bit

LIBRARY.md

Lines changed: 0 additions & 49 deletions
This file was deleted.

README.md

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ Data that is currently extracted includes:
3232

3333
An example binary is available to download
3434

35-
- `unifiedlog_iterator` - Can parse a logarchive into a JSOL or CSV file. It can also run
35+
- `unifiedlog_iterator` - Can parse a logarchive into a JSOL or CSV file. It can also parse the logs
3636
on a live system. The output file will be quite large
3737

3838
## Limitations
@@ -43,7 +43,7 @@ the Unified Log format there are some limitations:
4343
1. No printf style error code lookup support. This library does not do any error
4444
code lookups for log messages. The native `log` command on macOS supports
4545
error code lookups when it encounters printf style `%m` messages.\
46-
An example base log messsage: 'Failed to open file, error: %m'\
46+
For example the log message: 'Failed to open file, error: %m'\
4747
a. This Library outputs:
4848
```
4949
Failed to open file, error: 1
@@ -53,12 +53,11 @@ the Unified Log format there are some limitations:
5353
Failed to open file, error: no such file or directory
5454
```
5555

56-
2. Support for most custom objects in log messages. However, some objects are
57-
not supported. Unsupported objects will be base64 encoded
56+
2. This library supports most custom objects in log messages. However, unsupported objects will be base64 encoded
5857

5958
# References
6059

61-
https://github.com/ydkhatri/UnifiedLogReader\
62-
https://github.com/libyal/dtformats/blob/main/documentation/Apple%20Unified%20Logging%20and%20Activity%20Tracing%20formats.asciidoc\
63-
https://eclecticlight.co/2018/03/19/macos-unified-log-1-why-what-and-how/\
64-
https://www.crowdstrike.com/blog/how-to-leverage-apple-unified-log-for-incident-response/
60+
- https://github.com/ydkhatri/UnifiedLogReader
61+
- https://github.com/libyal/dtformats/blob/main/documentation/Apple%20Unified%20Logging%20and%20Activity%20Tracing%20formats.asciidoc
62+
- https://eclecticlight.co/2018/03/19/macos-unified-log-1-why-what-and-how
63+
- https://www.crowdstrike.com/blog/how-to-leverage-apple-unified-log-for-incident-response

0 commit comments

Comments
 (0)