Skip to content

Commit

Permalink
README.md: document better what libsqsh actually is
Browse files Browse the repository at this point in the history
  • Loading branch information
Gottox committed Aug 29, 2023
1 parent cbaeba0 commit 764a60b
Showing 1 changed file with 19 additions and 1 deletion.
20 changes: 19 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,24 @@

A fresh squashfs implementation. BSD-2 licensed.

squashfs is an open and free compressed read-only filesystem. It is used in
embedded devices, live-CDs, or in packaging. It was original introduced into
the kernel, but there are multiple user space implementations.

*libsqsh* is a purely 2-Clause BSD Licensed implementation of the squashfs
filesystem in C11. It covers the complete squashfs feature set, while still
being as minimal as possible.

*libsqsh* consists of a C library and a command line tools to interact with
squashfs archives.

Note that *libsqsh* only supports reading squashfs archives. If you want to create
squashfs archives, you can either use
[squashfs-tools](https://github.com/plougher/squashfs-tools/), which provides a
command line interface, or
[squashfs-tools-ng](https://github.com/AgentD/squashfs-tools-ng/), which provides both
which provides both a command-line interface and a C library interface.

## Features

* **Complete feature set**: libsqsh supports all features of the squashfs file
Expand All @@ -10,7 +28,7 @@ A fresh squashfs implementation. BSD-2 licensed.
* **Modern C11 implementation**: Written in modern C11, libsqsh is designed for
efficiency and compatibility with C++, C, and other languages.

* **High-Level API**: The high-level API provides easy-to-use functions to
* **High-Level API**: The high-level API provides easy-to-use functions to
access the contents of a to the contents of a squashfs archive. It is designed
for ease of use and interface to the squashfs archive.

Expand Down

0 comments on commit 764a60b

Please sign in to comment.