This is an old revision of the document!

Usage:
      bufrextract.pl <bufr file(s)>
          [--ahl <ahl_regexp>]
          [--only_ahl] | [--without_ahl]
          [--reuse_ahl n]
          [--help]
          [--outfile <filename>]
          [--verbose n]

Options:
       --ahl <ahl_regexp> Extract BUFR messages and/or AHLs with AHL
                          matching <ahl_regexp> only
       --only_ahl         Extract AHLs only
       --without_ahl      Extract BUFR messages only
       --reuse_ahl n  n=0 (default) AHL is considered belonging to a BUFR message
                          only if immediately preceding
                      n=1 When filtering using --ahl: Reuse last AHL found if current
                          BUFR message has no immediately preceding AHL
       --help             Display Usage and explain the options used. For even
                          more info you might prefer to consult perldoc bufrextract.pl
       --outfile <filename>
                          Will print to <filename> instead of STDOUT
       --verbose n        Set verbose level to n, 0<=n<=6 (default 0)

    Options may be abbreviated, e.g. "--h" or "-h" for "--help".

    For option "--ahl" the <ahl_regexp> should be a Perl regular expression.
    E.g. "--ahl 'ISS... ENMI'" will decode only BUFR SHIP (ISS) from
    CCCC=ENMI.

    If the BUFR file is known to consist solely of GTS bulletins, you
    probably should use "--reuse 1" when applying "--ahl", in order to
    extract all (and not only the first) BUFR messages in multi message
    bulletins (such bulletins are very rare, though). Note that the
    corresponding AHL is still extracted only once.

    No bufrtables are needed for running bufrextract.pl, since section 4 in
    BUFR message will not be decoded (which also speeds up execution quite a
    bit).