summaryrefslogtreecommitdiffstats
path: root/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL56
1 files changed, 56 insertions, 0 deletions
diff --git a/INSTALL b/INSTALL
new file mode 100644
index 0000000000..2dcc27f9c5
--- /dev/null
+++ b/INSTALL
@@ -0,0 +1,56 @@
+#
+# $Id$
+#
+
+NOTE: The string <release> should be replaced with
+ the appropriate release number of RTEMS.
+
+This file only discusses the installation of .tgz files.
+For more detailed information on the installation of RTEMS,
+refer to the Release Notes manual in the file
+/pub/rtems/releases/<release>/doc/c_or_ada/relnotes.tgz on
+lancelot.gcs.redstone.army.mil.
+
+UNCOMPRESSING .tgz FILES
+===========================
+Many of the files found in this directory and its subdirectories
+are gzip'ed, tar archive files. These files have the ".tgz"
+extension. They were compressed with gzip version 1.2.4.
+
+Use a command sequence similar to the following to uncompress each
+file:
+
+ gzcat FILE.tgz | tar xvof -
+
+where FILE.tgz is the file to be installed. This procedure will
+extract the files in the archive into the current directory.
+All of the .tgz files associated with this release RTEMS will
+place their contents in a subdirectory rtems-<release> in the current
+directory.
+
+If you are unsure of what is in an RTEMS archive file, then use
+the following command sequence to get a listing of the contents:
+
+ gzcat FILE.tgz | tar tvf -
+
+NOTES:
+
+(1) The "-o" option to tar is included on the tar command line
+ so that the user extracting the tar archive will own the extracted
+ files.
+
+(2) gzcat is sometimes installed as zcat. Be warned that on many
+ (most) UNIX machines, zcat is associated with compress (.Z files).
+
+(3) If you do not have gzip 1.2.4, it is available from numerous sites
+ including this one. Other sites include prep.ai.mit.edu and
+ gatekeeper.dec.com.
+
+(4) The GNU archive files included in this distribution are packaged
+ exactly like they are on official GNU ftp sites. When extracting
+ GNU archives, they will not extract under a rtems-<version>
+ directory. They will extract themselves under a directory which
+ is the name and version of the tool in question. For example,
+ gcc-2.5.8.tgz will extract its contents into the subdirectory
+ gcc-2.5.8.
+