1cernlib-static(1)           General Commands Manual          cernlib-static(1)
2
3
4
5"CERNlib commands"
6

NAME

8       cernlib-static - get libraries needed to link with CERN Program Library
9

SYNOPSIS

11       cernlib-static [options] library[/version] ...
12
13

DESCRIPTION

15       cernlib-static  writes  to  standard  output a list of object libraries
16       needed to link a program with the given library(s)  of  CERNlib;  other
17       libraries  needed  implicitely,  both CERNlib and system libraries, are
18       added automatically.  library may be any of the CERNlib libraries using
19       a short name like packlib, mathlib, graflib, phtools...
20
21       version  allows  to  specify which version to use for this library, see
22       usage notes.
23
24
25   Options
26       cernlib-static recognizes the following options:
27
28
29       -G driver  specifies the graphics interface to use.  Defaults  to  X11.
30                  The choices available depend on the system in use:
31
32                     X11    all systems. On HP/UX X11R5 is used when available
33                            on the system.
34
35                     Motif  all systems. On HP/UX Motif1.2 is used when avail‐
36                            able on the system.
37
38                     GKS    Vendor  specific graphics, DEC Ultrix, IBM/RS6000,
39                            SUN only
40
41                     GPR    Vendor specific graphics, Apollo only.
42
43                     GL     Vendor specific graphics, IBM/RS6000 and SGI only.
44
45
46       -s         obsolete option. Ignored.
47
48
49       -l         Don't link against system lapack and blas.
50
51
52       -u         do not automatically add vendor libraries  needed  to  link,
53                  but not specified by the user.
54
55
56       -v version Use  level version of CERNlib libraries; version can be pro,
57                  new or old, or you may specify the explicit version  number;
58                  the  default version is pro. The global version can be over‐
59                  written for an individual library by specifying the  library
60                  as library/version.
61
62
63   USAGE
64       cernlib-static  expects to find the CERNlib directory tree in /cern; if
65       your system does not have this, set the environment  variable  CERN  to
66       contain the name of the root directory for the CERNlib tree.
67
68       After the library a version for that library different from the default
69       version may be specified. The possible values are as for the -v option,
70       or in the case of graflib as for the -G option.
71
72
73   EXAMPLES
74       As  cernlib-static  writes  the  list  of libraries to standard output,
75       using it as a command will show the  list  of  libraries  generated  by
76       cernlib-static. Also, it can be used like other commands in the command
77       line surrounded by back quotes(`).  At CERN you should use  the  hepf77
78       command  to  link  on your system as this gives the compiler parameters
79       which are compatible with Cernlib (in particular for xlf on  IBM/RS6000
80       and fort77 on HP/UX ) you could type:
81            hepf77 your.o `cernlib-static`
82       to  link  your  object file with routines from packlib and kernlib; you
83       need not specify packlib, as this  is  added  automatically.  Also  all
84       kernlib  routines  are  included  in packlib.  If your application uses
85       graflib and the Motif interface, the command would be:
86            hepf77 your.o `cernlib-static graflib/Motif`
87       Again packlib need not be specified.
88
89       If you prefer to have an environment  variable  CERNLIB  set  at  login
90       time, put the following into
91             .profile for sh, ksh or similar
92                 CERNLIB=`cernlib-static graflib`; export CERNLIB
93             .login for users of csh of similar
94                 setenv CERNLIB "`cernlib-static graflib`"
95       The  CERNLIB  variable  can then be used in the link command instead of
96       calling the cernlib-static command.
97
98
99   BUGS
100       There is no checking that any of the libraries (or options)  are  valid
101       or  exist.   Most  loaders  only  check the libraries once for symbols,
102       hence the order the libraries given is important. This command does not
103       check that the order given is correct.
104
105       For  systems  other  than Alliant, Apollo, DEC Ultrix, Digital Unix (or
106       DEC OSF), HP/UX, SGI, Linux, Sun OS, Sun Solaris  the  libraries  given
107       for  the  graphics  interface  are likely to be wrong, even for X11 and
108       Motif.
109
110
111   FILES
112       The cernlib-static command is available in the /cern/pro/bin  directory
113       in the CERNlib tree.
114
115
116   CONTACT Address
117       If  you  have suggestions for improvements, or find bugs, please report
118       them to
119            cernlib@cern.ch.
120       Your report must state which version of CERNlib you are using,  or  the
121       output of the command:
122            what `which cernlib-static`
123
124
125
126CERN Program Library     $Date: 1998/05/19 16:32:03 $        cernlib-static(1)