Extract files from a YAFFS2 file system image
Switch branches/tags
Nothing to show
Clone or download
Latest commit 39bd7d4 Mar 29, 2018
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Added README, license, Makefile Jul 17, 2011
Makefile removing the leftover debian flag Mar 31, 2013
README correct spelling mistake Aug 31, 2017
gpl-2.0.txt Added README, license, Makefile Jul 17, 2011
unyaffs.1 Changed man page formatting Mar 31, 2013
unyaffs.c Version 0.9.7 Mar 29, 2018
unyaffs.h Minor formatting changes Jul 17, 2011

README

unyaffs
=======

Overview
--------

  Unyaffs is a program to extract files from a YAFFS2 file system image.
  Currently it can only extract images created by mkyaffs2image.

  Unyaffs is based on work of the YAFFS project, see http://www.yaffs.net/

  The original implementation was done by Kai Wei <kai.wei.cn@gmail.com>,
  it is available at http://code.google.com/p/unyaffs/

  As the project was inactive, Bernhard Ehlers <be@bernhard-ehlers.de>
  started a fork at https://github.com/ehlers/unyaffs


License
-------

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License version 2 as
  published by the Free Software Foundation.

  The full license text is available in the file gpl-2.0.txt.


Requirements
------------

  Unyaffs should run on most unix-like operating systems.
  A C compiler environment and make is necessary to compile it.


Compiling
---------

  type "make"


Usage
-----

  unyaffs - extract files from a YAFFS2 file system image.

  Usage: unyaffs [options] <image_file_name> [<extract_directory>]

  Options:
      -d               detection of flash layout, no extraction
      -b               spare contains bad block information
      -c <chunk size>  set chunk size in KByte (default: autodetect, max: 16)
      -s <spare size>  set spare size in Byte  (default: autodetect, max: 512)
      -t               list image contents
      -v               verbose output
      -V               print version

  In most cases the flash memory layout is detected automatically.
  If the detection doesn't work properly, the layout can be set with
  options -c and -s. If spare contains bad block info, set option -b.

  Option -t lists all the file names in the image without extracting them.
  Option -v generates a 'ls -l' like listing of the extracted files.
  When combined with -t it generates an extended file listing, nothing
  is extracted.

  The image file can be - for standard input.

  If the extraction directory is not given, the files are stored into the
  current directory. If the extraction dir doesn't exist, it will be created.

  unyaffs extracts all file types (regular files, directories, soft links,
  hard links and special files). The permissions and modification dates
  are restored. When run as root, the ownership is restored as well.

  Please be careful extracting images as root. It might be possible,
  that important system files get overwritten. The use of chroot
  or fakeroot can guard against these problems.

Limitations
-----------

  Block and character devices can only be restored as root. In some
  operating systems (e.g. Mac OS X) sockets can't be restored.

  The use of special files (block devices, character devices, pipes,
  sockets) is not portable across different unix flavors. E.g. device
  files created on linux will get a strange major and minor device id,
  when restored under BSD.

  When it's necessary to deal with special files, please use the same
  OS as used in the system the image is build for. In most cases that's
  linux.

Windows
-------

  The differences between the unix and windows file system are big enough
  to make a windows port of unyaffs a complicated task. But with cygwin
  (http://www.cygwin.com/) a unix compatibility layer for windows is
  available. The unmodified source compiles and runs nicely within cygwin.

  The main differences to a pure unix environment:
  - Unix functionality only within cygwin environment, native windows
    programs won't see the more advanced features.
  - Permissions and file dates/time are correctly restored
  - Owner/group are not fully restored, only user/groups available in windows
  - Hard and soft links are correctly restored
  - Device files have different ids as in linux
  - Sockets are not restored

  For analysis of a firmware image, unyaffs within cygwin is a nice tool,
  but because of the restricted user/group functionality rebuilding a
  modified image can't be recommended.