NAME

       cernlib - print CERN library dependencies

SYNOPSIS

       cernlib [options] libraries

DESCRIPTION

       cernlib is a tool to list the compiler and linker options necessary to compile a CERNLIB program that has
       the  given library dependencies.  It is generally used within a command substitution, as in the following
       example:

       gfortran -o myprogram myprogram.F `cernlib -G Motif pawlib`

       This version of cernlib has been completely rewritten from the original script provided by CERN.  It  now
       does recursive library dependency checking and removes duplicate entries.

       Note  that  by  default,  the  cernlib  script  assumes  that the CERN libraries are to be linked against
       statically; if the environment variables $CERN or $CERN_ROOT are specified, it looks  for  the  libraries
       only in the "lib" subdirectory of those locations, not any "shlib" subdirectory.  Furthermore, the script
       brackets  the  CERN  libraries with linker instructions to link statically.  This is done to preserve the
       original upstream behavior, in which all CERNLIB libraries exist only  in  static  form.   For  instance,
       "cernlib packlib" outputs:

       -Wl,-static -lpacklib -lkernlib -Wl,-dy -lm -lnsl -lcrypt -ldl -lg2c

       If  you want to link against ALL libraries (including CERNLIB) either statically or dynamically, call the
       cernlib script with its -safe flag to omit these bracketing linker flags.  That is: if you want  to  link
       against  all libraries (not just CERNLIB) statically, use the -static compiler flag and call cernlib with
       its -safe flag:

       gfortran -o myprogram myprogram.F -static `cernlib -safe -G Motif pawlib`

       and if you want to link against all libraries (including the CERN libraries) dynamically,  use  the  same
       command without the -static compiler flag (the linker assumes dynamic linking by default):

       gfortran -o myprogram myprogram.F `cernlib -safe -G Motif pawlib`

OPTIONS

       -a arch
              Specify a system architecture, e.g. Linux (default), AIX, HP-UX, etc.

       -dy    Equivalent to -safe; for backwards compatibility.

       -G driver
              Specify  a  graphics  driver.  The available options on Linux are X11 and Motif (the latter option
              will also work when the Lesstif library is present).

       -P, -s Ignored; for backwards compatibility.

       -safe  Do not make any assumptions about whether the CERN libraries should be linked against  dynamically
              or statically.  (The default behavior, if this flag is not used, is to link them statically.)

       -u     Do not include architecture-specific libraries in the output.

       -v version
              Specify version of $CERN_LEVEL.  This is meaningless unless you have installed an upstream version
              of CERNLIB (i.e. not packaged by Debian); see the file /usr/share/doc/cernlib-base/README.Debian.

       -?, --help
              Show a summary of options.

       --     Tell cernlib that this marks the end of cernlib-specific flags, and all following arguments are to
              be  parsed as described in the LIBRARIES section below.  If -- is not given, the first word parsed
              as a library name will be the first word not starting with a hyphen "-" that is not an argument to
              a preceding cernlib flag.

LIBRARIES

       The following library names are recognized by this version of the cernlib script.   These  names  may  be
       used exactly as shown here, or prefixed by "-l".

       Core CERN libraries
              mathlib, packlib, kernlib

       Graphics and PAW libraries
              graflib, pawlib

       Monte Carlo and GEANT libraries
              cojets, eurodec, geant321, herwig59, isajet758, pdflib804, photos202, phtools

       Additional Monte Carlo libraries
              (to obtain these, see /usr/share/doc/montecarlo-base/README.Debian)
              ariadne, ariadne-p5, fritiof, jetset, lepto, pythia5, pythia6

       Aliases
              The numerals at the end may be left off most of the library names above.

       Other library names
              Various  other  names  are  recognized  for  backwards  compatibility, internal use, and non-Linux
              architectures.  For the complete list, please see the cernlib script.

       Other  Any names not recognized by cernlib that start with "-l" or with any character other than a hyphen
              ("-") are output as -l${name#-l} (i.e., are assumed to be  a  library).   Names  starting  with  a
              hyphen  for which the second character is not "l" are assumed to be compiler flags, and are output
              at the beginning of the line before all other output.

SEE ALSO

       /usr/share/doc/cernlib-base/README.Debian describes some of the changes that have been made to  the  CERN
       libraries in order to comply with Debian policy and the Filesystem Hierarchy Standard.

       CERNLIB  documentation  for  all  related  libraries  and  programs  is  available  at the following URL:
       http://cern.ch/cernlib/

AUTHOR

       This manual page and the version of the cernlib script that it describes were written  by  Kevin  McCarty
       <kmccarty@debian.org>  for  the  Debian  GNU/Linux system (but may be used by others).  They are licensed
       under the GNU General Public License, version 2 or later (at your choice).

COPYRIGHT

       Copyright (C) Kevin B. McCarty, 2002, 2003, 2004, 2005, 2006.

                                                   Jan 6, 2005                                        CERNLIB(1)