https://github.com/fhunleth/mmccopy

Convenient alternative to dd for writing images to SDCards
https://github.com/fhunleth/mmccopy

Last synced: 2 months ago
JSON representation

Convenient alternative to dd for writing images to SDCards

• Host: GitHub
• URL: https://github.com/fhunleth/mmccopy
• Owner: fhunleth
• License: mit
• Created: 2013-11-09T04:54:46.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2015-02-01T00:23:10.000Z (almost 10 years ago)
• Last Synced: 2024-05-09T12:29:07.137Z (8 months ago)
• Language: C
• Homepage:
• Size: 484 KB
• Stars: 14
• Watchers: 8
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

README

        
# Overview

[![Build Status](https://travis-ci.org/fhunleth/mmccopy.png)](https://travis-ci.org/fhunleth/mmccopy) [![Coverity Scan Build Status](https://scan.coverity.com/projects/4100/badge.svg)](https://scan.coverity.com/projects/4100)

The `mmccopy` utility is an easier-to-use alternative to `dd` for

writing images to SDCards and MMC memory. It has the following

features:

  1. Write image data from `stdin` or a file directly to an offset on

  the device (this is similar to `dd` except that offsets are

  specified in bytes instead of blocks)

  2. Batch up writes into 1 MiB blocks by default to improve transfer

  rate. (`dd` defaults to 512 byte blocks without the `bs` argument)

  3. Automatically unmount partitions that are using the device. This

  prevents data corruption either due to latent writes from the

  mounted file systems or due to image writes being cached.

  4. Provide human and machine readable progress similar to using `pv`

  with `dd`, except with the improvement that the percentages track

  completed writes rather than initiated writes.

  5. Automatic detection of MMC and SDCards. This option queries the

  user before writing anything by default to avoid accidental

  overwrites.

  6. Optionally run a TRIM command on the MMC or SDCard before writing

  to it. This lets you quickly reset the entire memory contents even

  if you're only going to write a fraction of it. This is only available

  on devices and SDCard readers that support the TRIM command.

Here's an example run:

    $ sudo mmccopy -p sdcard.img

    Use memory card found at /dev/sdc? [y/N] y

    100%

    $

# Building from source

Clone or download the source code and run the following:

    ./autogen.sh

    ./configure

    make

    make install

# Invoking

```

Usage: mmccopy [options] [path]

  -d 

  -n   Report numeric progress

  -o 

  -p   Report progress (default)

  -q   Quiet

  -r   Read from the memory card

  -s 

  -t   Run the TRIM command on the memory card before copying

  -v   Print out the version and exit

  -w   Write to the memory card (default)

  -y   Accept automatically found memory card

The [path] specifies the location of the image to copy to or from

the memory card. If it is unspecified or '-', the image will either

be read from stdin (-w) or written to stdout (-r).

Examples:

Write the file sdcard.img to an automatically detected SD Card:

  mmccopy sdcard.img

Read the master boot record (512 bytes @ offset 0) from /dev/sdc:

  mmccopy -r -s 512 -o 0 -d /dev/sdc mbr.img

Offset and size may be specified with the following suffixes:

    b  512

   kB  1000

    K  1024

  KiB  1024

   MB  1000000

    M  1048576

  MiB  1048576

   GB  1000000000

    G  1073741824

  GiB  1073741824

```