Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/calccrypto/tar
A simple tar implementation in C
https://github.com/calccrypto/tar
c commandline-interface extract linux tar
Last synced: 7 days ago
JSON representation
A simple tar implementation in C
- Host: GitHub
- URL: https://github.com/calccrypto/tar
- Owner: calccrypto
- License: mit
- Created: 2015-08-25T17:26:58.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2024-01-15T20:14:49.000Z (10 months ago)
- Last Synced: 2024-08-01T19:44:31.107Z (3 months ago)
- Topics: c, commandline-interface, extract, linux, tar
- Language: C
- Homepage:
- Size: 19.5 KB
- Stars: 113
- Watchers: 4
- Forks: 35
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## A simple tar implementation
Copyright (c) 2015 Jason Lee @ calccrypto at gmail.com
Please see LICENSE file for license.
[![Build Status](https://travis-ci.com/calccrypto/tar.svg?branch=master)](https://travis-ci.com/calccrypto/tar)
This is only a simple implementation of the tar file format.
It can tar files and extract them. That is about it. Although
there are some other utility functions written, they are a very
small subset that are provided by GNU Tar. Everything was written
based on Wikipedia and the observed results of GNU Tar.This only works on Linux (or Linux-like environment, such as cygwin)
due to the sheer number of POSIX header files being used. The minimum
C standard needed is C99.The purpose of this is to be a tar library that can be used
inside other programs, so that programs don't have to call
or perform the tarring outside of the program (such as with
system, exec, or through a script)To build:
make - creates libtar.a
make exec - makes the commandline interface 'exec'
make test - tests the commandline interfaceUsage:
The library consists of some core functions for basic funtionality,
some utility functions that expand on functionality, and some internal
functions that should not be called from outside the function.Core Functions | Description
-------------------|---------------------------
tar_read | Read from a tar file. Expects address to a null pointer.
tar_write | Write to a tar file. If a non-empty archive is also provided, the new files will be appended to the older data.
tar_free | Frees up memory used by existing archive instances.
-------------------------
Utility Functions | Description
-------------------|-------------------------
tar_ls | Prints the contents of an archive. Verbosity level changes what is printed.
tar_extract | Extracts the contents of an archive. A filter list can be provided to only extract certain files.
tar_update | Scans through the current working directory and appends any files that are updates of archive entries.
tar_remove | Given a list of entries, removes those entries from the archive.
tar_diff | Checks for differences between entries in the archive and the current working directory.Many of these functions are just wrappers around internal functions.
All functions that involve changing the data in a `struct tar_t *` will
take in the address of the archive (`struct tar_t **`).If any function that modifies archive variables errors, it is most
likely that the data held in the archive variable is no longer valid.The commandline interface only has a handful of options, each of which
runs one or more of the public functions. Type `help` into the commandline
interface to see its usage.