Man Linux: Main Page and Category List

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