\input texinfo

     [file gcc-common.texi not included]

Copyright (C) 2002 Free Software Foundation, Inc.

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with the Invariant Sections being ``GNU General Public License'', the Front-Cover texts being (a) (see below), and with the Back-Cover Texts being (b) (see below).  A copy of the license is included in the section entitled ``GNU Free Documentation License''.

(a) The FSF's Front-Cover Text is:

A GNU Manual

(b) The FSF's Back-Cover Text is:

You have freedom to copy and modify this GNU Manual, like GNU software.  Copies published by the Free Software Foundation raise funds for GNU development.

Introduction
************

This manual describes how to use jar and grepjar.

Invoking jar
************

fastjar is an implementation of Sun's jar utility that comes with the JDK, written entirely in C, and runs in a fraction of the time while being feature compatible.

If any file is a directory then it is processed recursively.  The manifest file name and the archive file name needs to be specified in the same order the -m and -f flags are specified.

Exactly one of the following actions must be specified:

-c
     Create new archive.

-t
     List table of contents for archive.

-x
     Extract named (or all) files from archive.

-u
     Update existing archive. This option is disabled due to bugs (currently fails with exit status 1 and does nothing).

The following parameters are optional:

-@
     Read the names of the files to add to the archive from stdin.  This option is supported only in combination with -c or -u. Non standard option added in the GCC version.

-C DIRECTORY
     Change to the DIRECTORY and include the following file.

-E
     Prevent fastjar from reading the content of a directory when specifying one (and instead relying on the provided list of files to populate the archive with regard to the directory entry). Non standard option added in the GCC version.

-M
     Do not create a manifest file for the entries.

-0
     Store only; use no ZIP compression.

-V
--version
     Display version information.

-f ARCHIVE
     Specify archive file name.

-m MANIFEST
     Include manifest information from specified MANIFEST file.

-v
     Generate verbose output on standard output.

All remaining options are considered to be names of files.

Invoking grepjar
****************

The grepjar program can be used to search files in a jar file for a pattern.

-b
     Print byte offset of match.

-c
     Print number of matches.

-i
     Compare case-insensitively.

-n
     Print line number of each match.

-s
     Suppress error messages.

-w
     Force PATTERN to match only whole words.

-e PATTERN
     Use PATTERN as regular expression.

--help
     Print help, then exit.

-V
--version
     Print version number, then exit.

     [file gpl.texi not included]

     [file fdl.texi not included]