Bmapflash NPM | npm.io

bmapflash

Flash an image using a .bmap file

Installation

Install bmapflash by running:

$ npm install --save bmapflash

Documentation

bmapflash
- .flashImageToFileDescriptor(imageStream, deviceFileDescriptor, bmapContents, [options]) ⇒ EventEmitter
- .validateFlashedImage(deviceFileDescriptor, bmapContents) ⇒ EventEmitter

bmapflash.flashImageToFileDescriptor(imageStream, deviceFileDescriptor, bmapContents, options) ⇒ EventEmitter

Kind: static method of bmapflash
Summary: Flash image to file descriptor
Returns: EventEmitter - event emitter
Access: public

Param	Type	Default	Description
imageStream	ReadableStream		image stream
deviceFileDescriptor	Number		device file descriptor
bmapContents	String		bmap contents
options	Object	{}	options
options.bytesToZeroOutFromTheBeginning	Number	0	bytes to zero out from the beginning

Example

fs.open('/dev/rdisk2', 'rs+', (error, fd) => {
  if (error) {
    throw error;
  }

  fs.readFile('my/image.bmap', {
    encoding: 'utf8'
  }, (error, bmapContents) => {
    if (error) {
      throw error;
    }

    const image = fs.createReadStream('path/to/image.img');

    const flasher = bmapflash.flashImageToFileDescriptor(image, fd, bmapContents);

    flasher.on('progress', (state) => {
      console.log(state);
    });

    flasher.on('error', (error) {
      throw error;
    });

    flasher.on('done', () => {
      console.log('Done!');
    });
  });
});

bmapflash.validateFlashedImage(deviceFileDescriptor, bmapContents) ⇒ EventEmitter

This function reads all the mapped blocks as specified by the .bmap file, generates checksums, and compares them to the checksums specified in the .bmap file.

The returned event emitter might emit the following events:

done (Object[]): Emitted when all the blocks have been scanned. This event passes as an argument an array of objects containing the ranges that did not pass validation.
error (Error): Emitted when an error happened.
progress (Object): Emitted regularly, passing an object containing progress state information.

Kind: static method of bmapflash
Summary: Validate flashed image
Returns: EventEmitter - event emitter
Access: public

Param	Type	Description
deviceFileDescriptor	Number	device file descriptor
bmapContents	String	bmap contents

Example

fs.open('/dev/rdisk2', 'rs+', (error, fd) => {
  if (error) {
    throw error;
  }

  fs.readFile('my/image.bmap', {
    encoding: 'utf8'
  }, (error, bmapContents) => {
    if (error) {
      throw error;
    }

    const validator = bmapflash.validateFlashedImage(fd, bmapContents);

    validator.on('progress', (state) => {
      console.log(state);
    });

    validator.on('error', (error) {
      throw error;
    });

    validator.on('done', (invalidRanges) => {
      if (invalidRanges.length !== 0) {
        console.log('Validation was not successful');
      }
    });
  });
});