Return to mars.6 CVS log

Up to [Research Unix] / researchv10dc / man / mana

Annotation of researchv10dc/man/mana/mars.6, revision 1.1

1.1     ! root        1: .TH MARS 6 
        !             2: .SH NAME
        !             3: mars \- memory array redcode simulator
        !             4: .SH SYNOPSIS
        !             5: .B mars 
        !             6: [
        !             7: .B -dfhmp
        !             8: ]
        !             9: [
        !            10: .BI -cqs value
        !            11: ]
        !            12: .I file ...
        !            13: .SH DESCRIPTION
        !            14: .I Mars
        !            15: is a simulator for the
        !            16: `Redcode'
        !            17: machine from Kee Dewdney,s
        !            18: `Computer Recreations,'
        !            19: .I Scientific American ,
        !            20: May, 1984, coded by Michael Mauldin, CMU.
        !            21: The easiest way to create an object file is to use the
        !            22: .IR redcode (6)
        !            23: command to a assemble the object file from a redcode
        !            24: source file.
        !            25: .PP
        !            26: An object file contains three header lines: the name of the
        !            27: program, its length, and its starting location.
        !            28: Here is a sample redcode object file, for
        !            29: the Dwarf program:
        !            30: .IP
        !            31: .EX
        !            32: name dwarf
        !            33: length 4
        !            34: start 1
        !            35: 00000007999
        !            36: 20000517999
        !            37: 10000027998
        !            38: 41799800000
        !            39: .EE
        !            40: .PP
        !            41: The instruction format is an 11 digit decimal string, packed thus:
        !            42: .EX
        !            43: struct {
        !            44:        char[1] opcode;
        !            45:        char[1] mode1; char[4] arg1;
        !            46:        char[1] mode2; char[4] arg2;
        !            47: }
        !            48: .EE
        !            49: .PP
        !            50: Options allow for tracing execution, for graphically displaying the
        !            51: progress of each program, and for analyzing and dumping memory before
        !            52: and after execution.  For example
        !            53: .IP
        !            54: .L
        !            55: mars -s1234 -f -c20000 dwarf.obj gemini.obj imp.obj
        !            56: .LP
        !            57: specifies that imp, dwarf, and gemini are to be run together, with a
        !            58: fullscreen display for 20000 cycles using a random number seed of 1234.
        !            59: .TP
        !            60: .BI -c N
        !            61: the maximum number of cycles for this run.
        !            62: The default is 10000.
        !            63: .TP
        !            64: .B -d
        !            65: (debug)
        !            66: execution to be traced in excruciating detail.
        !            67: .TP
        !            68: .B -f
        !            69: (fullscreen)
        !            70: execution will be displayed graphically on any
        !            71: terminal supported by
        !            72: .IR curses (3).
        !            73: .TP
        !            74: .B -h
        !            75: (holes)
        !            76: description of memory usage will be printed after
        !            77: execution terminates.
        !            78: .TP
        !            79: .B -m
        !            80: memory will be dumped before and after execution terminates.
        !            81: .TP
        !            82: .B -p
        !            83: similar to
        !            84: .BR -m ,
        !            85: except only memory near each program counter is dumped.
        !            86: .TP
        !            87: .BI -q N
        !            88: .I
        !            89: quit as soon as there are fewer than
        !            90: .I N
        !            91: programs still alive.
        !            92: Default is 
        !            93: .BR q1 .
        !            94: .TP
        !            95: .BI -s N
        !            96: seed for random number generator;
        !            97: .IR N =0
        !            98: seeds from the clock.
        !            99: .SH SEE ALSO
        !           100: .IR redcode (6)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.