gcc/fastjar
Tom Tromey 847450b41d jartool.c (extract_jar): Unconditionally read extra data in the entry header...
* jartool.c (extract_jar): Unconditionally read extra data in the
	entry header; don't read it after the file contents.

From-SVN: r87990
2004-09-23 23:40:33 +00:00
..
.cvsignore acinclude.m4: Quote first argument of AC_DEFUNs. 2004-06-15 07:36:33 +00:00
AUTHORS
CHANGES
COPYING
ChangeLog jartool.c (extract_jar): Unconditionally read extra data in the entry header... 2004-09-23 23:40:33 +00:00
INSTALL
Makefile.am re PR bootstrap/16164 (automake 1.8.5 upgrade changed fastjar into a read-write source directory) 2004-08-11 00:56:23 +00:00
Makefile.in re PR bootstrap/16164 (automake 1.8.5 upgrade changed fastjar into a read-write source directory) 2004-08-11 00:56:23 +00:00
NEWS
README
acinclude.m4 acinclude.m4: Quote first argument of AC_DEFUNs. 2004-06-15 07:36:33 +00:00
aclocal.m4 acinclude.m4: Quote first argument of AC_DEFUNs. 2004-06-15 07:36:33 +00:00
compress.c [multiple changes] 2004-07-06 21:40:08 +00:00
compress.h [multiple changes] 2004-07-06 21:40:08 +00:00
config.h.in re PR java/16472 (jartool.c uses ftruncate, nonexistant on mingw32) 2004-07-19 21:08:20 +01:00
configure re PR java/16472 (jartool.c uses ftruncate, nonexistant on mingw32) 2004-07-19 21:08:20 +01:00
configure.ac re PR java/16472 (jartool.c uses ftruncate, nonexistant on mingw32) 2004-07-19 21:08:20 +01:00
dostime.c
dostime.h
fastjar.texi Makefile.am: Rename jar binary to fastjar. 2004-07-23 23:34:17 +00:00
install-defs.sh.in
jargrep.c
jargrep.h
jartool.c jartool.c (extract_jar): Unconditionally read extra data in the entry header... 2004-09-23 23:40:33 +00:00
jartool.h [multiple changes] 2004-07-06 21:40:08 +00:00
pushback.c
pushback.h
shift.c [multiple changes] 2004-07-06 21:40:08 +00:00
shift.h [multiple changes] 2004-07-06 21:40:08 +00:00
zipfile.h [multiple changes] 2004-07-06 21:40:08 +00:00

README

This directory contains the FastJar package, which is not part of GCC but
shipped with GCC as convenience.

=======
FastJar 0.90

12/6/1999
=======

FastJar is an attempt at creating a feature-for-feature copy of Sun's JDK's
'jar' command.  Sun's jar (or Blackdown's for that matter) is written entirely
in Java which makes it dog slow.  Since FastJar is written in C, it can create
the same .jar file as Sun's tool in a fraction of the time.  On my system,
Sun's jar takes 50 seconds to create a 10MB jar file, while FastJar only takes
a little over a second.  

The reason I wrote fastjar is that building .jar files is a regular process
of the build where I work.  The way we have it setup, you have to re-create
the .jar file everytime you want to test it out, which is about every 5 minutes
when I'm busy coding.  The .jar file wasn't -that- big, but it did take about
30 seconds to be made, and watching all the garbage collection messages was
pretty irritating as well.  I probably wasted a half-hour a day watching
Sun's jar tool chug along.  By writing the program in C, I spend much less time
banging my head against the monitor waiting for the build to finish.  Yay!

FastJar has been tested on Solaris and Linux 2.2.x systems and nothing else. 
It should compile/run without any problems on either system, provided you have
zlib installed.  

Please mail any bug reports to burnsbr@ucs.orst.edu.

If you use FastJar and want me to add the rest of the features, send me mail
(toast@users.sourceforge.net).  I'll be much more likely to put more work into this
if I know other people find it useful other than me.

As always, this not being a final release, bugs may exist.  I test each
release pretty well, but I can always miss things...

Compression will slow things down quite a bit.  A 10MB jar file takes about
1 second on my machine without compression, and 9 seconds with it.  If you
want fastjar to be fast, use the -0 (zero, not O) flag to turn off compression.

Supported flags:
--------------------------
-c  | create a new archive
-v  | verbose output
-f  | specify archive file name
-m  | specify existing manifest file
-M  | don't create manifest
-0  | store only
-C  | change to dir
-t  | list contents
-x  | extract contents

Unsupported flags:
----------------------------
-u  | update exisiting archive

If you use the "unsupported" flags, nothing bad will happen, but then again
nothing will happen at all.  


Unsupported features (in this release):
---------------------------------------------
  * updating
  * full manifest support (?)

Order or features for the future:
--------------------------------------------
  * archive updating
  * full manifest support
  * filtering
  * dependency checking


===========================================================================
http://fastjar.sourceforge.net
toast@users.sourceforge.net