X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=doc%2Fsim65.sgml;h=0739ea2f1a8f33a59596e7b0ddee7f0b55693bc2;hb=74455508314bc2b007e812ec5f9429496b9fbd5f;hp=f80f17c92f720eb926d9a7b8083d232ec3427541;hpb=22348e2f0712dd2590a51b1d93e0beb056fbd6ad;p=cc65 diff --git a/doc/sim65.sgml b/doc/sim65.sgml index f80f17c92..0739ea2f1 100644 --- a/doc/sim65.sgml +++ b/doc/sim65.sgml @@ -4,7 +4,6 @@ sim65 Users Guide <author><url url="mailto:polluks@sdf.lonestar.org" name="Stefan A. Haubenthal"> -<date>2016-01-05 <abstract> sim65 is a simulator for 6502 and 65C02 CPUs. It allows to test target @@ -28,17 +27,19 @@ binary needs to be compiled with <tt/--target sim6502/ or <tt/--target sim65c02/ The simulator is called as follows: <tscreen><verb> - Usage: sim65 [options] file [arguments] - Short options: - -h Help (this text) - -v Increase verbosity - -V Print the simulator version number - -x <num> Exit simulator after <num> cycles - - Long options: - --help Help (this text) - --verbose Increase verbosity - --version Print the simulator version number + Usage: sim65 [options] file [arguments] + Short options: + -h Help (this text) + -c Print amount of executed CPU cycles + -v Increase verbosity + -V Print the simulator version number + -x <num> Exit simulator after <num> cycles + + Long options: + --help Help (this text) + --cycles Print amount of executed CPU cycles + --verbose Increase verbosity + --version Print the simulator version number </verb></tscreen> @@ -53,6 +54,13 @@ Here is a description of all the command line options: Print the short option summary shown above. + <tag><tt>-c, --cycles</tt></tag> + + Print the number of executed CPU cycles when the program terminates. + The cycles for the final "<tt>jmp exit</tt>" are not included in this + count. + + <tag><tt>-v, --verbose</tt></tag> Increase the simulator verbosity. @@ -73,15 +81,15 @@ Here is a description of all the command line options: <sect>Input and output<p> -The simulator will read one binary file per invocation and can log some -library calls. +The simulator will read one binary file per invocation and can log the +program loading and paravirtualization calls to stderr. Example output for the command <tscreen><verb> sim65 --verbose --verbose samples/gunzip65 </verb></tscreen> <tscreen><verb> -Loaded `samples/gunzip65' at $0200-$151F +Loaded 'samples/gunzip65' at $0200-$151F PVWrite ($0001, $13C9, $000F) GZIP file name:PVWrite ($0001, $151F, $0001) @@ -112,14 +120,14 @@ including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions: <enum> -<item> The origin of this software must not be misrepresented; you must not - claim that you wrote the original software. If you use this software - in a product, an acknowledgment in the product documentation would be - appreciated but is not required. -<item> Altered source versions must be plainly marked as such, and must not - be misrepresented as being the original software. -<item> This notice may not be removed or altered from any source - distribution. +<item> The origin of this software must not be misrepresented; you must not + claim that you wrote the original software. If you use this software + in a product, an acknowledgment in the product documentation would be + appreciated but is not required. +<item> Altered source versions must be plainly marked as such, and must not + be misrepresented as being the original software. +<item> This notice may not be removed or altered from any source + distribution. </enum> </article>