diff options
-rw-r--r-- | myMemory.1 | 88 |
1 files changed, 30 insertions, 58 deletions
@@ -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 |
3 | myMemory.py \- Memory paging simulator | 3 | myMemory.py \- Memory paging simulator |
4 | .SH SYNOPSIS | 4 | .SH SYNOPSIS |
5 | myMemory.py [-h] -s <main mem size> -v <virtual mem size> -a <fifo> | 5 | myMemory.py [-h] -s <main mem size> -v <virtual mem size> -a <algorithm> |
6 | .SH DESCRIPTION | 6 | .SH DESCRIPTION |
7 | .B foo | 7 | .B myMemory |
8 | frobnicates the bar library by tweaking internal | 8 | Simulates 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. |
9 | symbol tables. By default it parses all baz segments | ||
10 | and rearranges them in reverse order by time for the | ||
11 | .BR xyzzy (1) | ||
12 | linker to find them. The symdef entry is theni compressed | ||
13 | using the WBG (Whiz-Bang-Gizmo) algorithm. | ||
14 | All files are processed in the order specified. | ||
15 | .SH OPTIONS | 9 | .SH OPTIONS |
16 | .IP -b | 10 | .IP -h |
17 | Do not write `busy' to stdout while processing. | 11 | Displays a short help text. |
18 | .IP "-c config-file" | 12 | .IP "-s <main mem size>" |
19 | Use the alternate system wide | 13 | Specifies the size of the main memory. Mandatory argument. |
20 | .I config-file | 14 | .IP "-v <virtual mem size>" |
21 | instead of | 15 | Specifies the size of the virtual (secondary) memory. Mandatory argument. |
22 | .IR /etc/foo.conf . | 16 | .IP "-a <algorithm>" |
23 | This overrides any | 17 | Uses the specified page management algorithm. Available algorithms are listed below. |
24 | .B FOOCONF | 18 | .SH PAGING ALGORITHMS |
25 | environment variable. | 19 | .IP fifo |
26 | .IP -a | 20 | "First-in, first-out" strategy replacing the oldest loaded page with the requested one. Clock-variant. |
27 | In addition to the baz segments, also parse the | 21 | .IP random |
28 | blurfl headers. | 22 | Selects and replaces a page randomly. |
29 | .IP -r | 23 | .IP lru |
30 | Recursive 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. |
31 | at 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 | 28 | The following commands can be used to interact with the simulator: |
35 | The system wide configuration file. See | 29 | .IP "A number" |
36 | .BR foo (5) | 30 | Requests a page to be loaded in the main memory. |
37 | for further details. | 31 | .IP `p` |
38 | .RE | 32 | Lists the pages in the main and secondary memories. |
39 | .I ~/.foorc | 33 | .IP `x` |
40 | .RS | 34 | Exits the program. |
41 | Per user configuration file. See | ||
42 | .BR foo (5) | ||
43 | for further details. | ||
44 | .SH ENVIRONMENT | ||
45 | .IP FOOCONF | ||
46 | If non-null the full pathname for an alternate system wide | ||
47 | .IR foo.conf . | ||
48 | Overridden by the | ||
49 | .B -c | ||
50 | option. | ||
51 | .SH DIAGNOSTICS | ||
52 | The following diagnostics may be issued on stderr: | ||
53 | |||
54 | Bad magic number. | ||
55 | .RS | ||
56 | The input file does not look like an archive file. | ||
57 | .RE | ||
58 | Old style baz segments. | ||
59 | .RS | ||
60 | .B foo | ||
61 | can only handle new style baz segments. COBOL | ||
62 | object 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 |
82 | Pacien TRAN-GIRARD | 54 | Pacien TRAN-GIRARD, |
83 | Adam NAILI | 55 | Adam NAILI |
84 | 56 | ||