aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorpacien2018-04-06 18:24:46 +0200
committerpacien2018-04-06 18:24:46 +0200
commitf96822a8b3d9f0979b8716a26c67b979ff35fd3e (patch)
treeae88ed20e507e4c0f382a8632b9f6ee6a1472306
parentae5823f486af88b8ad8d0dd3258d205a284e9833 (diff)
downloadmempager-simulator-f96822a8b3d9f0979b8716a26c67b979ff35fd3e.tar.gz
Update man page
-rw-r--r--myMemory.188
1 files changed, 30 insertions, 58 deletions
diff --git a/myMemory.1 b/myMemory.1
index 1093e66..9fe2d0f 100644
--- a/myMemory.1
+++ b/myMemory.1
@@ -1,65 +1,37 @@
1.TH MYMEMORY 1 "MARCH 2018" UPEM "myMemory manual" 1.TH MYMEMORY 1 "APRIL 2018" UPEM "myMemory manual"
2.SH NAME 2.SH NAME
3myMemory.py \- Memory paging simulator 3myMemory.py \- Memory paging simulator
4.SH SYNOPSIS 4.SH SYNOPSIS
5myMemory.py [-h] -s <main mem size> -v <virtual mem size> -a <fifo> 5myMemory.py [-h] -s <main mem size> -v <virtual mem size> -a <algorithm>
6.SH DESCRIPTION 6.SH DESCRIPTION
7.B foo 7.B myMemory
8frobnicates the bar library by tweaking internal 8Simulates a virtual memory manager, allowing the user to load requested pages into a main memory, extended with a virtual memory of a fixed size. The simulator handles several paging strategies, which are detailed below.
9symbol tables. By default it parses all baz segments
10and rearranges them in reverse order by time for the
11.BR xyzzy (1)
12linker to find them. The symdef entry is theni compressed
13using the WBG (Whiz-Bang-Gizmo) algorithm.
14All files are processed in the order specified.
15.SH OPTIONS 9.SH OPTIONS
16.IP -b 10.IP -h
17Do not write `busy' to stdout while processing. 11Displays a short help text.
18.IP "-c config-file" 12.IP "-s <main mem size>"
19Use the alternate system wide 13Specifies the size of the main memory. Mandatory argument.
20.I config-file 14.IP "-v <virtual mem size>"
21instead of 15Specifies the size of the virtual (secondary) memory. Mandatory argument.
22.IR /etc/foo.conf . 16.IP "-a <algorithm>"
23This overrides any 17Uses the specified page management algorithm. Available algorithms are listed below.
24.B FOOCONF 18.SH PAGING ALGORITHMS
25environment variable. 19.IP fifo
26.IP -a 20"First-in, first-out" strategy replacing the oldest loaded page with the requested one. Clock-variant.
27In addition to the baz segments, also parse the 21.IP random
28blurfl headers. 22Selects and replaces a page randomly.
29.IP -r 23.IP lru
30Recursive mode. Operates as fast as lightning 24"Least Recently Used" strategy keeping track of the last request time of each page and replacing the least recently used one.
31at the expense of a megabyte of virtual memory. 25.IP secondchance
32.SH FILES 26"Second chance" strategy similar to FIFO, but avoiding swapping out pages requested twice while they are in the main memory.
33.I /etc/foo.conf 27.SH COMMANDS
34.RS 28The following commands can be used to interact with the simulator:
35The system wide configuration file. See 29.IP "A number"
36.BR foo (5) 30Requests a page to be loaded in the main memory.
37for further details. 31.IP `p`
38.RE 32Lists the pages in the main and secondary memories.
39.I ~/.foorc 33.IP `x`
40.RS 34Exits the program.
41Per user configuration file. See
42.BR foo (5)
43for further details.
44.SH ENVIRONMENT
45.IP FOOCONF
46If non-null the full pathname for an alternate system wide
47.IR foo.conf .
48Overridden by the
49.B -c
50option.
51.SH DIAGNOSTICS
52The following diagnostics may be issued on stderr:
53
54Bad magic number.
55.RS
56The input file does not look like an archive file.
57.RE
58Old style baz segments.
59.RS
60.B foo
61can only handle new style baz segments. COBOL
62object libraries are not supported in this version.
63.SH EXAMPLE 35.SH EXAMPLE
64.nf 36.nf
65% ./myMemory.py -s 3 -v 5 -a fifo 37% ./myMemory.py -s 3 -v 5 -a fifo
@@ -79,6 +51,6 @@ object libraries are not supported in this version.
79> x 51> x
80.fi 52.fi
81.SH AUTHORS 53.SH AUTHORS
82Pacien TRAN-GIRARD 54Pacien TRAN-GIRARD,
83Adam NAILI 55Adam NAILI
84 56