Git Product home page Git Product logo

mkepr's Introduction

mkepr

Description

mkepr is a command line tool that creates EPROM or Flash image files containing files from the host system, ready to be used by the Cambridge Z88 emulators ZESarUX and OZvm.

Requirements

mkepr has been written in Forth for Gforth, and needs two modules of the Forth Foundation Library.

Gforth and the Forth Foundation Library must be installed on the system.

Installation

Make sure the <mkepr.fs> is executable. Then copy, move or link it to a directory on your path.

Example for single-user installation:

chmod u+x mkepr.fs
ln mkepr.fs ~/bin/mkepr

Example for system-wide installation:

chmod ugo+x mkepr.fs
ln mkepr.fs /usr/local/bin/mkepr

Usage

Syntax and options

Usage: mkepr [options] [files]

  -?, --help        show this help
      --version     show version info
  -f, --flash       create an Intel Flash card instead of an EPROM card
  -o, --output=FILE set output file; default: output.epr (or output.flash)
  -s, --size=KiB    set the card size; defaults: 32 KiB (EPROM), 512 KiB
                    (Flash)
  -q, --quiet       quiet mode: input files will not be listed

Usage examples

Note: mkepr must receive a literal list of filenames (including their paths). Sometimes a shell regular expression is enough, but sometimes find must be used.

Create a default EPROM card containing all text files from the current directory:

mkepr *.txt

Create a 128-KiB EPROM card containing all text files from the current directory and all Forth sources from the forth subdirectory (which will be preserved in the card):

mkepr --size=128 --output=forth.epr *.txt forth/*.fs

Create a 512-KiB Flash card containing all files of the current directory and all subdirectories (the:

mkepr -f -s 512 -o /tmp/eprom.flash $(find  -name "*" -type f)

Known issues

Filenames are checked according to the rules of the OZ file system, and the program halts if any of their segments (sections between slashes) is invalid. No attempt is made to adapt invalid filenames, except removing the "./" prefix when present, right before the actual checks. This means the input files must be on the current directory. For example, the following command will not work: mkepr ../file.txt.

mkepr's People

Contributors

programandala-net avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.