From df61a1d3ef548aab24f065f6086621a09b5eea0d Mon Sep 17 00:00:00 2001 From: Ali Saidi Date: Wed, 28 Jul 2004 17:56:36 -0400 Subject: [PATCH] updated readme to reflect linux/scons changes Put correct date in copyright headers based on bk changesets LICENSE: Updated copyright on license file README: Updaded readme to reflect shift to scons and linux support cpu/trace/reader/ibm_reader.cc: cpu/trace/reader/ibm_reader.hh: cpu/trace/reader/itx_reader.cc: cpu/trace/reader/itx_reader.hh: cpu/trace/reader/m5_reader.cc: cpu/trace/reader/m5_reader.hh: cpu/trace/reader/mem_trace_reader.cc: cpu/trace/reader/mem_trace_reader.hh: cpu/trace/trace_cpu.cc: cpu/trace/trace_cpu.hh: updated copyright (only changeset in 2004) kern/kernel_stats.cc: kern/kernel_stats.hh: updated copyright --HG-- extra : convert_revision : 726aed4b38ff4d230c63a570df83c63075b3c76f --- LICENSE | 2 +- README | 56 ++++++++++++++++------------ cpu/trace/reader/ibm_reader.cc | 2 +- cpu/trace/reader/ibm_reader.hh | 2 +- cpu/trace/reader/itx_reader.cc | 2 +- cpu/trace/reader/itx_reader.hh | 2 +- cpu/trace/reader/m5_reader.cc | 2 +- cpu/trace/reader/m5_reader.hh | 2 +- cpu/trace/reader/mem_trace_reader.cc | 2 +- cpu/trace/reader/mem_trace_reader.hh | 2 +- cpu/trace/trace_cpu.cc | 2 +- cpu/trace/trace_cpu.hh | 2 +- 12 files changed, 43 insertions(+), 35 deletions(-) diff --git a/LICENSE b/LICENSE index 8ecb95578..3c9fd6627 100644 --- a/LICENSE +++ b/LICENSE @@ -1,4 +1,4 @@ -Copyright (c) 2000-2003 The Regents of The University of Michigan +Copyright (c) 2000-2004 The Regents of The University of Michigan All rights reserved. Redistribution and use in source and binary forms, with or without diff --git a/README b/README index f5651ec00..fe5b99f23 100644 --- a/README +++ b/README @@ -1,4 +1,3 @@ - This is release m5_1.0_beta1 of the M5 simulator. This file contains brief "getting started" information and release @@ -13,13 +12,23 @@ distribution. The archive you've unpacked has three subdirectories: - m5: the simulator itself - m5-test: regression tests and scripts to run them - ext: less-common external packages needed to build m5 - (currently just "ply") + (currently ply and libelf) -Although M5 is capable of full-system simulation, the only OS it -currently supports is the proprietary Compaq/HP Tru64 version of Unix. -We are thus unable to distribute bootable disk images freely. If you -have a Tru64 license and are interested in obtaining disk images, -contact us at m5-dev@eecs.umich.edu. +M5 is a capable, full-system simulator that current supports both Linux +2.4/2.6 and the proprietary Compaq/HP Tru64 version of Unix. We are able +to distribute Linux bootdisks, but we are unable to distribute bootable +disk images of Tru64 Unix. If you have a Tru64 license and are interested +in obtaining disk images, contact us at m5-dev@eecs.umich.edu. + +WHAT'S NEEDED +------------- +-GCC(3.X) +-Python(2.2.2+) + +WHAT'S RECOMMENDED +------------------ +-MySQL (for statistics complex statistics storage/retrieval) +-Python-MysqlDB (for statistics analysis) GETTING STARTED --------------- @@ -28,24 +37,23 @@ The following steps will build and test the simulator. The variable "$top" refers to the top directory where you've unpacked the files, i.e., the one containing the m5, m5-test, and ext directories. -cd $top/m5/setup -./setup ALPHA # set up build/ALPHA directory -cd $top/m5/build/ALPHA -make m5.opt # use "-j N" if you've got an MP system -# wait for build... +There are three different build targets and three optimizations in each level: +Target: +------- +ALPHA - Syscall emulation simulation +KERNEL - Linux full system simulation +KERNEL_TLASER - Tru64 Unix full system simulation + +Optimization: +------------- +m5.debug - debug version of the code with tracing and without optimization +m5.opt - optimized version of code with tracing +m5.fast - optimized version of the code without tracing and asserts + +cd $top/m5/build +scons TARGET/OPTLEVL # e.g. KERNEL/m5.opt, use -j N if you have a MP system cd $top/m5-test ./do-tests.pl -B ALPHA # test what you just built +./do-tests.pl -B KERNEL # test what you just built # wait for tests to run... # should end with "finished do-tests successfully!" - -If you run into errors regarding m5/arch/alpha/decoder.cc, just -"touch" that file to update its timestamp. This file is generated -from a compact ISA description using a program written in Python. If -you have Python 2.2.2 or later installed on your system, you should be -able to generate it yourself, but if you don't have Python (or have an -older version), you may run in to trouble. Since we've shipped a -working copy of decoder.cc, it's not necessary to have Python to build -M5 (unless you start modifying the ISA decription). Unfortunately, -sometimes make gets confused and tries to do so anyway. The "touch" -should convince make to stop trying. - diff --git a/cpu/trace/reader/ibm_reader.cc b/cpu/trace/reader/ibm_reader.cc index 439931dba..7ca32fe21 100644 --- a/cpu/trace/reader/ibm_reader.cc +++ b/cpu/trace/reader/ibm_reader.cc @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003-2004 The Regents of The University of Michigan + * Copyright (c) 2004 The Regents of The University of Michigan * All rights reserved. * * Redistribution and use in source and binary forms, with or without diff --git a/cpu/trace/reader/ibm_reader.hh b/cpu/trace/reader/ibm_reader.hh index 0f14da24d..f7e3ae149 100644 --- a/cpu/trace/reader/ibm_reader.hh +++ b/cpu/trace/reader/ibm_reader.hh @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003-2004 The Regents of The University of Michigan + * Copyright (c) 2004 The Regents of The University of Michigan * All rights reserved. * * Redistribution and use in source and binary forms, with or without diff --git a/cpu/trace/reader/itx_reader.cc b/cpu/trace/reader/itx_reader.cc index 54bbbc4ea..593d383ec 100644 --- a/cpu/trace/reader/itx_reader.cc +++ b/cpu/trace/reader/itx_reader.cc @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003-2004 The Regents of The University of Michigan + * Copyright (c) 2004 The Regents of The University of Michigan * All rights reserved. * * Redistribution and use in source and binary forms, with or without diff --git a/cpu/trace/reader/itx_reader.hh b/cpu/trace/reader/itx_reader.hh index ff74062ea..0e08d5db5 100644 --- a/cpu/trace/reader/itx_reader.hh +++ b/cpu/trace/reader/itx_reader.hh @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003-2004 The Regents of The University of Michigan + * Copyright (c) 2004 The Regents of The University of Michigan * All rights reserved. * * Redistribution and use in source and binary forms, with or without diff --git a/cpu/trace/reader/m5_reader.cc b/cpu/trace/reader/m5_reader.cc index d081f0bc0..c5b807824 100644 --- a/cpu/trace/reader/m5_reader.cc +++ b/cpu/trace/reader/m5_reader.cc @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003-2004 The Regents of The University of Michigan + * Copyright (c) 2004 The Regents of The University of Michigan * All rights reserved. * * Redistribution and use in source and binary forms, with or without diff --git a/cpu/trace/reader/m5_reader.hh b/cpu/trace/reader/m5_reader.hh index d78787461..296c99ccf 100644 --- a/cpu/trace/reader/m5_reader.hh +++ b/cpu/trace/reader/m5_reader.hh @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003-2004 The Regents of The University of Michigan + * Copyright (c) 2004 The Regents of The University of Michigan * All rights reserved. * * Redistribution and use in source and binary forms, with or without diff --git a/cpu/trace/reader/mem_trace_reader.cc b/cpu/trace/reader/mem_trace_reader.cc index c6fc53f51..441e72b80 100644 --- a/cpu/trace/reader/mem_trace_reader.cc +++ b/cpu/trace/reader/mem_trace_reader.cc @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003-2004 The Regents of The University of Michigan + * Copyright (c) 2004 The Regents of The University of Michigan * All rights reserved. * * Redistribution and use in source and binary forms, with or without diff --git a/cpu/trace/reader/mem_trace_reader.hh b/cpu/trace/reader/mem_trace_reader.hh index 5da99a498..6b6f804af 100644 --- a/cpu/trace/reader/mem_trace_reader.hh +++ b/cpu/trace/reader/mem_trace_reader.hh @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003-2004 The Regents of The University of Michigan + * Copyright (c) 2004 The Regents of The University of Michigan * All rights reserved. * * Redistribution and use in source and binary forms, with or without diff --git a/cpu/trace/trace_cpu.cc b/cpu/trace/trace_cpu.cc index 6122fc786..94f311d4b 100644 --- a/cpu/trace/trace_cpu.cc +++ b/cpu/trace/trace_cpu.cc @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003 The Regents of The University of Michigan + * Copyright (c) 2004 The Regents of The University of Michigan * All rights reserved. * * Redistribution and use in source and binary forms, with or without diff --git a/cpu/trace/trace_cpu.hh b/cpu/trace/trace_cpu.hh index 13a204f4e..6f3ef50a6 100644 --- a/cpu/trace/trace_cpu.hh +++ b/cpu/trace/trace_cpu.hh @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003 The Regents of The University of Michigan + * Copyright (c) 2004 The Regents of The University of Michigan * All rights reserved. * * Redistribution and use in source and binary forms, with or without