summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorGravatar Nikias Bassen2021-06-07 02:01:35 +0200
committerGravatar Nikias Bassen2021-06-07 03:41:07 +0200
commit046b26150e004a8ac740e699c6c3e11be29e8f11 (patch)
tree8f59597463dccd81ca180a87668e53864c4b09ae /README.md
downloadlibimobiledevice-glue-046b26150e004a8ac740e699c6c3e11be29e8f11.tar.gz
libimobiledevice-glue-046b26150e004a8ac740e699c6c3e11be29e8f11.tar.bz2
Initial check-in of sources
Diffstat (limited to 'README.md')
-rw-r--r--README.md101
1 files changed, 101 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..caddead
--- /dev/null
+++ b/README.md
@@ -0,0 +1,101 @@
+# libimobiledevice-glue
+
+Library with common code used by the libraries and tools around the
+**libimobiledevice** project.
+
+## Features
+
+The main functionality provided by this library are **socket** helper
+functions and a platform independent **thread/mutex** implementation.
+Besides that it comes with a number of string, file, and plist helper
+functions, as well as some other commonly used code that was originally
+duplicated in the dedicated projects.
+
+## Projects using this library
+
+- [libusbmuxd](https://github.com/libimobiledevice/libusbmuxd)
+- [libimobiledevice](https://github.com/libimobiledevice/libimobiledevice)
+- [usbmuxd](https://github.com/libimobiledevice/usbmuxd)
+- [idevicerestore](https://github.com/libimobiledevice/idevicerestore)
+
+## Installation / Getting started
+
+### Debian / Ubuntu Linux
+
+First install all required dependencies and build tools:
+```shell
+sudo apt-get install \
+ build-essential \
+ checkinstall \
+ git \
+ autoconf \
+ automake \
+ libtool-bin \
+ libplist-dev \
+```
+
+Then clone the actual project repository:
+```shell
+git clone https://github.com/libimobiledevice/libimobiledevice-glue.git
+cd libimobiledevice-glue
+```
+
+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
+make
+sudo make install
+```
+
+## Usage
+
+This library is directly used by libusbmuxd, libimobiledevice, etc., so there
+is no need to do anything in particular.
+
+## Contributing
+
+We welcome contributions from anyone and are grateful for every pull request!
+
+If you'd like to contribute, please fork the `master` branch, change, commit and
+send a pull request for review. Once approved it can be merged into the main
+code base.
+
+If you plan to contribute larger changes or a major refactoring, please create a
+ticket first to discuss the idea upfront to ensure less effort for everyone.
+
+Please make sure your contribution adheres to:
+* Try to follow the code style of the project
+* Commit messages should describe the change well without being to short
+* Try to split larger changes into individual commits of a common domain
+
+## Links
+
+* Homepage: https://libimobiledevice.org/
+* Repository: https://git.libimobiledevice.org/libimobiledevice-glue.git
+* Repository (Mirror): https://github.com/libimobiledevice/libimobiledevice-glue.git
+* Issue Tracker: https://github.com/libimobiledevice/libimobiledevice-glue/issues
+* Mailing List: https://lists.libimobiledevice.org/mailman/listinfo/libimobiledevice-devel
+* Twitter: https://twitter.com/libimobiledev
+
+## License
+
+This library and utilities are 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, iPad, iPod, iPod Touch, Apple TV, Apple Watch, Mac, iOS,
+iPadOS, tvOS, watchOS, and macOS are trademarks of Apple Inc.
+
+This project is an independent software and has not been authorized, sponsored,
+or otherwise approved by Apple Inc.
+
+README Updated on: 2021-06-07