Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Contribute to GitLab
Sign in / Register
Toggle navigation
L
libplist
Project
Project
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
1
Issues
1
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
pwn
libplist
Commits
a9e684c1
Commit
a9e684c1
authored
Jun 12, 2020
by
Martin Szulecki
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Improve README.md with feature, installation and usage sections
parent
c1484998
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
66 additions
and
31 deletions
+66
-31
README.md
README.md
+66
-31
No files found.
README.md
View file @
a9e684c1
# libplist
## About
*
A small portable C library to handle Apple Property List files in binary or XML
format.
*
A small portable C library to handle Apple Property List files in binary or XML.
## Features
## Requirements
The project provides an interface to read and write plist files in binary or
XML format alongside a command-line utility named
`plistutil`
.
Software:
*
make
*
autoheader
*
automake
*
autoconf
*
libtool
*
pkg-config
*
gcc or clang
-
**Formats:**
Supports binary and XML format
-
**Utility:**
Provides a
`plistutil`
utility for the command-line
-
**Python:**
Provides Cython based bindings for Python
-
**Tested:**
Uses fuzzing and data compliance tests
-
**Efficient:**
Lean library with performance and resources in mind
Optional:
*
cython (Python bindings)
*
doxygen (Documentation)
## Installation / Getting started
##
Installation
##
# Debian / Ubuntu Linux
To compile run:
```
bash
First install all required dependencies and build tools:
```
shell
sudo
apt-get
install
\
build-essential
\
checkinstall
\
git
\
autoconf
\
automake
\
libtool-bin
```
If you want to optionally build the documentation or Python bindings use:
```
shell
sudo
apt-get
install
\
doxygen
\
cython
```
Then clone the actual project repository:
```
shell
git clone https://github.com/libimobiledevice/libplist.git
cd
libplist
```
Now you can build and install it:
```
shell
./autogen.sh
make
sudo
make
install
```
If you require a custom prefix or other option being passed to
`./configure`
you can pass them directly to
`./autogen.sh`
like this:
```
bash
./autogen.sh
--prefix
=
/opt/local
--without-cython
make
sudo
make
install
## Usage
Then simply run:
```
shell
plistutil
-i
foobar.plist
-o
output.plist
```
## Who/What/Where?
This converts the
`foobar.plist`
file to the opposite format, e.g. binary to
XML or vice versa, and outputs it to the
`output.plist`
file.
Please consult the usage information or manual page for a full documentation of
available command line options:
```
shell
plistutil
--help
man plistutil
```
*
Home: https://libimobiledevice.org/
*
Code:
`git clone https://git.libimobiledevice.org/libplist.git`
*
Code (Mirror):
`git clone https://github.com/libimobiledevice/libplist.git`
*
Tickets: https://github.com/libimobiledevice/libplist/issues
## Links
*
Homepage: https://libimobiledevice.org/
*
Repository: https://git.libimobiledevice.org/libplist.git
*
Repository (Mirror): https://github.com/libimobiledevice/libplist.git
*
Issue Tracker: https://github.com/libimobiledevice/libplist/issues
*
Mailing List: https://lists.libimobiledevice.org/mailman/listinfo/libimobiledevice-devel
*
Twitter: https://twitter.com/libimobiledev
## License
This project is licensed under the
[
GNU Lesser General Public License v2.1
](
https://www.gnu.org/licenses/lgpl-2.1.en.html
)
,
also included in the repository in the
`COPYING`
file.
## Credits
Apple, iPhone, iPod, and iPod Touch are trademarks of Apple Inc.
libplist is an independent software library and has not been
authorized,
sponsored, or otherwise approved by Apple Inc.
This project is an independent software library and has not been authorized,
sponsored, or otherwise approved by Apple Inc.
README Updated on: 2020-06-
08
README Updated on: 2020-06-
12
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment