path: root/INSTALL
diff options
authorJoel Sherrill <>1995-05-11 17:39:37 +0000
committerJoel Sherrill <>1995-05-11 17:39:37 +0000
commitac7d5ef06a6d6e8d84abbd1f0b82162725f98326 (patch)
tree9304cf759a73f2a1c6fd3191948f00e870af3787 /INSTALL
Initial revision
Diffstat (limited to 'INSTALL')
1 files changed, 56 insertions, 0 deletions
diff --git a/INSTALL b/INSTALL
new file mode 100644
index 0000000000..2dcc27f9c5
--- /dev/null
@@ -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
+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
+ 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
+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 -
+(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 and
+(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.