balena-image-fs
Version:
Image filesystem manipulation utilities
67 lines (46 loc) • 1.96 kB
Markdown
balena-image-fs
--------------
[](http://badge.fury.io/js/balena-image-fs)
[](https://david-dm.org/balena-io-modules/balena-image-fs.png)
[](https://travis-ci.org/balena-io-modules/balena-image-fs)
[](https://ci.appveyor.com/project/balena-io-modules/balena-image-fs)
Balena.io image filesystem manipulation utilities.
Role
----
The intention of this module is to provide low level utilities to Balena.io operating system data partitions.
**THIS MODULE IS LOW LEVEL AND IS NOT MEANT TO BE USED BY END USERS DIRECTLY**.
Installation
------------
Install `balena-image-fs` by running:
```sh
$ npm install --save balena-image-fs
```
Documentation
-------------
<a name="module_imagefs..interact"></a>
### imagefs~interact()
**Kind**: inner method of [<code>imagefs</code>](#module_imagefs)
**Summary**: Run a function with a node fs like interface for a partition
**Example**
```js
const contents = await interact('/foo/bar.img', 5, async (fs) => {
return await promisify(fs.readFile)('/bar/qux');
});
console.log(contents);
```
Support
-------
If you're having any problem, please [raise an issue](https://github.com/balena-io-modules/balena-image-fs/issues/new) on GitHub and the Balena.io team will be happy to help.
Tests
-----
Run the test suite by doing:
```sh
$ npm test
```
Contribute
----------
- Issue Tracker: [github.com/balena-io-modules/balena-image-fs/issues](https://github.com/balena-io-modules/balena-image-fs/issues)
- Source Code: [github.com/balena-io-modules/balena-image-fs](https://github.com/balena-io-modules/balena-image-fs)
License
-------
The project is licensed under the Apache 2.0 license.