Option Directories -- Example

This page attempts to present a summary of an actual working example of our opt structure, using actual filenames and directory listings.

Since this page is rather long, here's a quick-jump table to its various sections:

The Workstation
Convenience Directories
The /opt On the Master
The Actual Master opt Directory
The pkg and site Directories
A Typical Application Directory

The Workstation

Our tour starts with the /opt directory on the workstation. Here is an abbreviated listing:

$ ls -l /opt
total 176
drwxrwxrwx  11 bin        bin           1024 May 22 11:33 CC
lrwxrwxr-x   1 richards   user            12 Jul 17 09:40 Comm.pl -> mstr/Comm.pl
lrwxrwxr-x   1 richards   user            14 Jul 17 09:40 DECserver -> mstr/DECserver
drwxrwxrwx   9 bin        bin           1024 May 22 11:32 ansic
lrwxrwxr-x   1 richards   user            11 Jul  2 10:29 apache -> mstr/apache
lrwxrwxr-x   1 richards   user            10 Aug  1 12:17 arena -> mstr/arena
lrwxrwxr-x   1 richards   user            15 Aug  1 12:17 ascii2html -> mstr/ascii2html
drwxr-xr-x   7 root       sys           1024 May 23 15:31 atria
dr-xr-xr-x   7 bin        bin           1024 Apr 15  1997 audio
lrwxrwxr-x   1 richards   user             9 Jul  2 10:29 bash -> mstr/bash
lrwxrwxr-x   1 richards   user             9 Nov  4 12:53 bern -> mstr/bern
drwxrwsr-x   2 richards   user          6144 Nov  4 12:54 bin
 ...                                                       ...
drwxrwsr-x   2 richards   user          1024 Oct 29 06:40 include
drwxrwsr-x   2 richards   user          1024 Jul  2 10:29 info
 ...                                                       ...
drwxrwsr-x   3 richards   user          1024 Nov  4 12:54 lib
lrwxrwxr-x   1 richards   user            11 Jul  2 10:29 libXpm -> mstr/libXpm
lrwxrwxr-x   1 richards   user            12 Jul  2 10:29 libjpeg -> mstr/libjpeg
lrwxrwxr-x   1 richards   user            11 Jul  2 10:29 libpng -> mstr/libpng
lrwxrwxr-x   1 richards   user            13 Jul  2 10:29 llnlxdir -> mstr/llnlxdir
lrwxrwxrwx   1 root       user            19 Oct 17 15:14 lotus -> /net/srvr02/_c/lotus
 ...                                                       ...
lrwxrwxr-x   1 richards   user            20 Jun 19 14:20 mstr -> /net/srvr01/_c/opt.10
 ...                                                       ...
lrwxrwxr-x   1 richards   user             8 Jul  2 10:29 zip -> mstr/zip
lrwxrwxr-x   1 richards   user             9 Jul  2 10:29 zlib -> mstr/zlib

Some of the installed HP and third-party directories have been omitted, as have many of our application links. Notable parts of the listing are

HP application directories:
- CC
- ansic
- audio
Third-party application directories or links:
- atria (Rational's ClearCase, installed locally)
- lotus (Lotus Development's Notes, installed on a server)
Links to freely available applications:
- Comm.pl
- apache
- arena
- ascii2html
- bash
- llnlxdir
- zip
Links to freely available libraries:
- libXpm
- libjpeg
- libpng
- zlib
Links to locally maintained packages:
- DECserver
- bern
Note that they look the same as freely available packages at this level, because users typically don't care where a package came from.
Convenience directories:
- bin
- lib
- include
- info
The link to the master node, mstr.

Jump back to top

Convenience Directories

Here are excerpts from some of our convenience directories. First, /opt/bin, which contains links to executable application binaries:

$ ls -l /opt/bin
total 656
lrwxrwxr-x   1 richards   user            17 Jul  2 10:29 a2p -> /opt/perl/bin/a2p
lrwxrwxr-x   1 richards   user            24 Jul  2 10:29 addftinfo -> /opt/groff/bin/addftinfo
lrwxrwxr-x   1 richards   user            23 Jul  2 10:29 afmtodit -> /opt/groff/bin/afmtodit
lrwxrwxr-x   1 richards   user            24 Jul  2 10:29 anytopnm -> /opt/netpbm/bin/anytopnm
lrwxrwxr-x   1 richards   user            20 Aug  1 12:17 arena -> /opt/arena/bin/arena
lrwxrwxr-x   1 richards   user            30 Aug  1 12:17 ascii2html -> /opt/ascii2html/bin/ascii2html
lrwxrwxr-x   1 richards   user            26 Jul  2 10:29 asciitopgm -> /opt/netpbm/bin/asciitopgm
lrwxrwxr-x   1 richards   user            24 Jul  2 10:29 atktopbm -> /opt/netpbm/bin/atktopbm
lrwxrwxr-x   1 richards   user            40 Jul  2 10:29 b2m -> /opt/xemacs/bin/hppa1.1-hp-hpux10.20/b2m
lrwxrwxr-x   1 richards   user            18 Jul  2 10:29 bash -> /opt/bash/bin/bash
lrwxrwxr-x   1 richards   user            21 Jul  2 10:29 bashbug -> /opt/bash/bin/bashbug
lrwxrwxr-x   1 richards   user            18 Nov  4 12:54 bern -> /opt/bern/bin/bern
lrwxrwxr-x   1 richards   user            17 Jul  2 10:29 bggen -> /opt/xv/bin/bggen
lrwxrwxr-x   1 richards   user            27 Jul  2 10:29 bioradtopgm -> /opt/netpbm/bin/bioradtopgm
lrwxrwxr-x   1 richards   user            24 Jul  2 10:29 bmptoppm -> /opt/netpbm/bin/bmptoppm
lrwxrwxr-x   1 richards   user            26 Jul  2 10:29 brushtopbm -> /opt/netpbm/bin/brushtopbm
 ...                                                       ...
lrwxrwxr-x   1 richards   user            29 Jul  2 10:29 yuvsplittoppm -> /opt/netpbm/bin/yuvsplittoppm
lrwxrwxr-x   1 richards   user            24 Jul  2 10:29 yuvtoppm -> /opt/netpbm/bin/yuvtoppm
lrwxrwxr-x   1 richards   user            26 Jul  2 10:29 zeisstopnm -> /opt/netpbm/bin/zeisstopnm
lrwxrwxr-x   1 richards   user            16 Jul  2 10:29 zip -> /opt/zip/bin/zip
lrwxrwxr-x   1 richards   user            21 Jul  2 10:29 zipcloak -> /opt/zip/bin/zipcloak
lrwxrwxr-x   1 richards   user            20 Jul  2 10:29 zipgrep -> /opt/zip/bin/zipgrep
lrwxrwxr-x   1 richards   user            22 Jul  2 10:29 zipinfo -> /opt/unzip/bin/zipinfo
lrwxrwxr-x   1 richards   user            20 Jul  2 10:29 zipnote -> /opt/zip/bin/zipnote
lrwxrwxr-x   1 richards   user            21 Jul  2 10:29 zipsplit -> /opt/zip/bin/zipsplit

Notable aspects of this listing:

The directory contains nothing but links.
Many packages have several binaries, such as the netpbm tools (anytopnm, asciitopgm, atktopbm, etc.)
Again, at this level, locally maintained packages such as bern look the same as freely available packages such as bash.
All of the links have the same format: /opt/appname/bin/progname
Many of the links have the same creation date and time. That's when we first ran repln --opt on this node. Newer links were added using repln --opt --refresh.

The other convenience directories are quite similar. Here's our entire /opt/lib directory:

$ ls -l /opt/lib
total 62
lrwxrwxr-x   1 richards   user            20 Oct 29 06:46 Muttrc -> /opt/mutt/lib/Muttrc
drwxrwsr-x   3 richards   user          1024 Jul  2 12:26 X11
lrwxrwxr-x   1 richards   user            27 Jul  2 10:29 domains.pl -> /opt/wwwstat/lib/domains.pl
lrwxrwxr-x   1 richards   user            24 Jul  2 10:29 libXpm.a -> /opt/libXpm/lib/libXpm.a
lrwxrwxr-x   1 richards   user            25 Jul  2 10:29 libXpm.sl -> /opt/libXpm/lib/libXpm.sl
lrwxrwxr-x   1 richards   user            29 Jul  2 10:29 libcurses.a -> /opt/ncurses/lib/libncurses.a
lrwxrwxr-x   1 richards   user            26 Jul  2 10:29 libform.a -> /opt/ncurses/lib/libform.a
lrwxrwxr-x   1 richards   user            28 Jul  2 10:29 libform_g.a -> /opt/ncurses/lib/libform_g.a
lrwxrwxr-x   1 richards   user            26 Jul  2 10:29 libjpeg.a -> /opt/libjpeg/lib/libjpeg.a
lrwxrwxr-x   1 richards   user            26 Jul  2 10:29 libmenu.a -> /opt/ncurses/lib/libmenu.a
lrwxrwxr-x   1 richards   user            28 Jul  2 10:29 libmenu_g.a -> /opt/ncurses/lib/libmenu_g.a
lrwxrwxr-x   1 richards   user            29 Jul  2 10:29 libncurses.a -> /opt/ncurses/lib/libncurses.a
lrwxrwxr-x   1 richards   user            31 Jul  2 10:29 libncurses_g.a -> /opt/ncurses/lib/libncurses_g.a
lrwxrwxr-x   1 richards   user            27 Jul  2 10:29 libpanel.a -> /opt/ncurses/lib/libpanel.a
lrwxrwxr-x   1 richards   user            29 Jul  2 10:29 libpanel_g.a -> /opt/ncurses/lib/libpanel_g.a
lrwxrwxr-x   1 richards   user            24 Jul  2 10:29 libpng.a -> /opt/libpng/lib/libpng.a
lrwxrwxr-x   1 richards   user            31 Jul  2 10:29 libreadline.a -> /opt/readline/lib/libreadline.a
lrwxrwxr-x   1 richards   user            23 Jul  2 10:29 libtiff.a -> /opt/tiff/lib/libtiff.a
lrwxrwxr-x   1 richards   user            24 Jul  2 10:29 libtiff.sl -> /opt/tiff/lib/libtiff.sl
lrwxrwxr-x   1 richards   user            27 Jul  2 10:29 libz.1.0.4.sl -> /opt/zlib/lib/libz.1.0.4.sl
lrwxrwxr-x   1 richards   user            20 Jul  2 10:29 libz.a -> /opt/zlib/lib/libz.a
lrwxrwxr-x   1 richards   user            21 Jul  2 10:29 libz.sl -> /opt/zlib/lib/libz.sl
lrwxrwxr-x   1 richards   user            22 Jul  2 10:29 lynx.cfg -> /opt/lynx/lib/lynx.cfg
lrwxrwxr-x   1 richards   user            24 Oct 29 06:46 mime.types -> /opt/mutt/lib/mime.types
lrwxrwxr-x   1 richards   user            28 Jul  2 10:29 splitlog.rc -> /opt/wwwstat/lib/splitlog.rc
lrwxrwxr-x   1 richards   user            37 Jul  2 10:29 splitlog.rc.original -> /opt/wwwstat/lib/splitlog.rc.original
lrwxrwxr-x   1 richards   user            26 Nov  4 12:54 tdc-init.tcl -> /opt/bern/lib/tdc-init.tcl
lrwxrwxr-x   1 richards   user            35 Aug  1 12:17 txt2html-linkdict -> /opt/txt2html/lib/txt2html-linkdict
lrwxrwxr-x   1 richards   user            27 Jul  2 10:29 wwwstat.rc -> /opt/wwwstat/lib/wwwstat.rc
lrwxrwxr-x   1 richards   user            36 Jul  2 10:29 wwwstat.rc.original -> /opt/wwwstat/lib/wwwstat.rc.original
lrwxrwxr-x   1 richards   user            21 Jul  2 10:29 xvdocs.ps -> /opt/xv/lib/xvdocs.ps

Note these things:

There are far fewer entries here than in /opt/bin. That's because almost every application has one or more binaries, but only a few actually have libraries or other lib-related items.
Not everything here is a library. There are global configuration files (wwwstat.rc, lynx.cfg, Muttrc), documents (xvdocs.ps), and other application-specific files (tdc-init.tcl, txt2html-linkdict), as well.
There are both static libraries (libXpm.a) and dynamic libraries (libXpm.sl). Some packages provide both kinds, some only one.
The X11 directory. Under it is an app-defaults subdirectory, which contains links to X11 application default resource files. Some people would prefer that the app-defaults directory be made an /opt-level convenience directory instead of being hidden here. See the Open Questions section for more about this.

Finally, here's a bit of our /opt/man/man1 convenience directory:

$ ls -l /opt/man/man1
total 638
lrwxrwxr-x   1 richards   user            24 Jul  2 10:29 a2p.1 -> /opt/perl/man/man1/a2p.1
lrwxrwxr-x   1 richards   user            31 Jul  2 10:29 addftinfo.1 -> /opt/groff/man/man1/addftinfo.1
lrwxrwxr-x   1 richards   user            30 Jul  2 10:29 afmtodit.1 -> /opt/groff/man/man1/afmtodit.1
lrwxrwxr-x   1 richards   user            31 Jul  2 10:29 anytopnm.1 -> /opt/netpbm/man/man1/anytopnm.1
lrwxrwxr-x   1 richards   user            33 Jul  2 10:29 asciitopgm.1 -> /opt/netpbm/man/man1/asciitopgm.1
lrwxrwxr-x   1 richards   user            31 Jul  2 10:29 atktopbm.1 -> /opt/netpbm/man/man1/atktopbm.1
lrwxrwxr-x   1 richards   user            25 Jul  2 10:29 bash.1 -> /opt/bash/man/man1/bash.1
lrwxrwxr-x   1 richards   user            28 Jul  2 10:29 bashbug.1 -> /opt/bash/man/man1/bashbug.1
lrwxrwxr-x   1 richards   user            29 Nov  4 12:54 bern-tcl.1 -> /opt/bern/man/man1/bern-tcl.1
lrwxrwxr-x   1 richards   user            25 Nov  4 12:54 bern.1 -> /opt/bern/man/man1/bern.1
lrwxrwxr-x   1 richards   user            24 Jul  2 10:29 bggen.1 -> /opt/xv/man/man1/bggen.1
lrwxrwxr-x   1 richards   user            34 Jul  2 10:29 bioradtopgm.1 -> /opt/netpbm/man/man1/bioradtopgm.1
lrwxrwxr-x   1 richards   user            31 Jul  2 10:29 bmptoppm.1 -> /opt/netpbm/man/man1/bmptoppm.1
lrwxrwxr-x   1 richards   user            33 Jul  2 10:29 brushtopbm.1 -> /opt/netpbm/man/man1/brushtopbm.1
 ...                                                       ...
lrwxrwxr-x   1 richards   user            31 Jul  2 10:29 xpmtoppm.1 -> /opt/netpbm/man/man1/xpmtoppm.1
lrwxrwxr-x   1 richards   user            27 Jul  2 10:30 xsubpp.1 -> /opt/perl/man/man1/xsubpp.1
lrwxrwxr-x   1 richards   user            21 Jul  2 10:30 xv.1 -> /opt/xv/man/man1/xv.1
lrwxrwxr-x   1 richards   user            34 Jul  2 10:30 xvminitoppm.1 -> /opt/netpbm/man/man1/xvminitoppm.1
lrwxrwxr-x   1 richards   user            29 Jul  2 10:30 xvpictoppm.1 -> /opt/xv/man/man1/xvpictoppm.1
lrwxrwxr-x   1 richards   user            31 Jul  2 10:30 xwdtopnm.1 -> /opt/netpbm/man/man1/xwdtopnm.1
lrwxrwxr-x   1 richards   user            31 Jul  2 10:30 ybmtopbm.1 -> /opt/netpbm/man/man1/ybmtopbm.1
lrwxrwxr-x   1 richards   user            36 Jul  2 10:30 yuvsplittoppm.1 -> /opt/netpbm/man/man1/yuvsplittoppm.1
lrwxrwxr-x   1 richards   user            31 Jul  2 10:30 yuvtoppm.1 -> /opt/netpbm/man/man1/yuvtoppm.1
lrwxrwxr-x   1 richards   user            33 Jul  2 10:30 zeisstopnm.1 -> /opt/netpbm/man/man1/zeisstopnm.1
lrwxrwxr-x   1 richards   user            23 Jul  2 10:30 zip.1 -> /opt/zip/man/man1/zip.1
lrwxrwxr-x   1 richards   user            27 Jul  2 10:30 zipgrep.1 -> /opt/zip/man/man1/zipgrep.1
lrwxrwxr-x   1 richards   user            29 Jul  2 10:30 zipinfo.1 -> /opt/unzip/man/man1/zipinfo.1

More notable stuff:

The links look a lot like those in /opt/bin and /opt/lib. We like that.
There's usually one or more man pages for each binary. The users like that.
Again, at this level, locally maintained stuff like bern looks just like everything else.

Jump back to top

The `/opt` On the Master

Just for reference purposes, here's the listing of the /opt directory on our master opt node, srvr01:

$ ls -l /net/srvr01/opt
total 136
lrwxrwxr-x   1 richards   user            11 Jul  1 10:57 apache -> mstr/apache
dr-xr-xr-x   8 bin        bin           1024 May 23  1996 audio
lrwxrwxr-x   1 richards   user             9 Jul  1 10:57 bash -> mstr/bash
lrwxrwxrwx   1 dwe        user             8 Jul  1 10:44 bin -> mstr/bin
drwxrwxrwx   2 root       sys             24 Jun  4  1996 ccase_rls
dr-xr-xr-x  13 bin        bin           1024 May 23  1996 dce
drwxr-xr-x   6 root       bin           1024 Feb 25  1997 dcelocal
lrwxrwxr-x   1 richards   user            11 Jul  1 10:57 emacsd -> mstr/emacsd
 ...                                                       ...
lrwxrwxrwx   1 dwe        user            20 Jul  1 10:41 mstr -> /_c/opt.10
 ...                                                       ...
lrwxrwxr-x   1 richards   user            14 Jul  1 10:57 xfishtank -> mstr/xfishtank
lrwxrwxr-x   1 richards   user             9 Jul  1 10:57 xmps -> mstr/xmps
lrwxrwxr-x   1 richards   user            11 Jul  1 10:57 xpaint -> mstr/xpaint
lrwxrwxr-x   1 richards   user             7 Jul  1 10:57 xv -> mstr/xv
lrwxrwxr-x   1 richards   user             8 Jul  1 10:57 zip -> mstr/zip
lrwxrwxr-x   1 richards   user             9 Jul  1 10:57 zlib -> mstr/zlib

As mentioned elsewhere, it looks just like the /opt directory on any workstation, except its mstr link is to its local filesystem, not to an NFS-mounted directory.

The only people who use the /opt directory on the master node are those who are logged on to it. In our environment, that's a rare circumstance indeed.

Jump back to top

The Actual Master `opt` Directory

Our "real" opt directory, where all our public and local tools live, is on the machine "srvr01" in the directory /_c/opt.10 because we are serving HP-UX version 10.x machines from it. Here is a fragment of its contents:

$ ls -l /net/srvr01/_c/opt.10
total 126
lrwxrwxr-x   1 richards   user            19 Jul 17 09:37 Comm.pl -> pkg/Comm.pl-1.5beta
lrwxrwxr-x   1 dwe        user            18 Jul  2 12:53 DECserver -> site/DECserver-1.1
lrwxrwxr-x   1 dwe        user            16 Aug  1 10:10 apache -> pkg/apache-1.2.1
lrwxrwxrwx   1 dwe        user            16 Aug 13 22:49 arena -> pkg/arena-0.3.37
lrwxrwxr-x   1 dwe        user            14 Aug  1 10:23 ascii2html -> pkg/ascii2html-1
lrwxrwxr-x   1 richards   user             8 Jun 11 09:03 bash -> pkg/bash-2.0
lrwxrwxr-x   1 richards   user            13 Nov  4 12:52 bern -> site/bern-5.0
 ...                                                       ...
lrwxrwxr-x   1 dwe        user            12 Jul 31 12:20 man2html -> pkg/man2html-1
lrwxrwxr-x   1 dwe        user            19 Aug  1 10:21 mifmucker -> pkg/mifmucker-1.0.2
lrwxrwxr-x   1 richards   user            13 Oct 29 06:29 mutt -> pkg/mutt-0.85
lrwxrwxr-x   1 richards   user             9 Jun  4 12:50 ncftp -> pkg/ncftp-2.4.2
 ...                                                       ...
drwxrwsr-x  60 richards   user          2048 Oct 29 06:24 pkg
 ...                                                       ...
drwxrwsr-x   9 dwe        user          1024 Nov  4 12:47 site
 ...                                                       ...
lrwxrwxr-x   1 dwe        user            10 Jun  2 15:08 xpaint -> pkg/xpaint-2.4.8
lrwxrwxr-x   1 dwe        user             6 Jun  2 15:08 xv -> pkg/xv-3.10a
lrwxrwxr-x   1 dwe        user             7 May 28 15:27 zip -> pkg/zip-2.1
lrwxrwxr-x   1 dwe        user             8 Jun  2 15:20 zlib -> pkg/zlib-1.0.4

Salient features of the master opt directory:

The directory contains only links and two subdirectories, pkg and site. Since this isn't a real /opt directory, it doesn't contain any vendor or third-party package directories. Those are in srvr01's /opt directory, shown in another section.
The links all point into one of the two directories pkg or site.
The links all contain the package version number. This shows which version of the package is being "published" or "exported" to the world. It is these links which would be changed in order to switch to a different version of the package.

Jump back to top

The `pkg` and `site` Directories

Within the pkg and site directories we find the actual application directories:

$ ls -l /net/srvr01/_c/opt.10/pkg
total 3360
drwxrwsr-x   5 richards   user          1024 Jul 17 09:58 Comm.pl-1.5beta
drwxrwxr-x  14 dwe        user          1024 Jul 27 08:03 apache-1.2.1
drwxrwsrwx  14 dwe        user          1024 Jul  1 12:21 apache-1.2b10
drwxrwsr-x   5 dwe        user          2048 Oct 29 06:23 archives
drwxrwxr-x   5 dwe        user          1024 Aug  1 11:08 arena-0.3.34
drwxrwxr-x   5 dwe        user          1024 Aug  3 19:15 arena-0.3.35
drwxrwsrwx   5 dwe        user          1024 Aug 13 23:02 arena-0.3.37
drwxrwxr-x   4 dwe        user          1024 Jul 25 22:47 ascii2html-1
drwxrwsr-x   7 richards   user          1024 Jun 11 09:12 bash-2.0
drwxrwxr-x   5 dwe        user          1024 Jul 25 15:58 chimera-1.70p0
drwxrwsr-x   5 richards   user          1024 Aug  1 08:45 ckermit-6.0.192
drwxrwsr-x   4 richards   user          1024 Jun 19 10:48 emacsd-920622
drwxrwxr-x   6 dwe        user          1024 May 31 19:33 groff-1.10
 ...                                                       ...
drwxr-xr-x   6 dwe        user          1024 May 30 09:09 xpaint-2.4.8
drwxrwxr-x   7 dwe        user          1024 Jul 30 17:33 xv-3.10a
drwxrwsr-x   5 dwe        user          1024 May 28 16:10 zip-2.1
drwxrwxr-x   5 dwe        user          1024 May 30 11:02 zlib-1.0.4

Some of the interesting parts of this listing are:

The directory contains only directories, no links.
All directory names have the same form: appname-version, with the exception of the archives directory. It contains the original tarfiles for the freely available packages, as downloaded from the net.
Multiple versions of an application may exist in the pkg directory, such as is the case with arena here. Check the opt directory to see which version is being used by the rest of the machines on the network.

For the curious, here's a sample of what you'll find in the archives directory:

$ ls -l /net/srvr01/_c/opt.10/pkg/archives
total 81304
-rw-rw-rw-   1 dwe        user        693522 Jul 18 10:51 apache_1.2.1.tar.gz
-rw-rw-r--   1 dwe        user        663566 May 29 11:07 apache_1.2b10.tar.gz
-rw-rw-r--   1 dwe        user       1149508 Jul 30 14:13 arena-0.3.34.tar.gz
-rw-rw-rw-   1 dwe        user       1147493 Aug 13 22:43 arena-0.3.37.tar.gz
-rw-r--r--   1 richards   user       1349450 Dec 31  1996 bash-2.0.tar.gz
-rw-r--r--   1 richards   user        954898 Dec 31  1996 bash-doc-2.0.tar.gz
-rw-rw-r--   1 dwe        user        364102 May 30 10:34 chimera-1.70.tar.gz
-rw-r--r--   1 richards   user       1219130 Aug  1 08:18 cku192.tar.gz
-rw-r--r--   1 richards   user          3371 Jun 19 10:46 emacsd.tar.gz
-rw-rw-rw-   1 dwe        user       1652355 May 31 17:17 ghostscript-3.33.tar.gz
-rw-rw-rw-   1 dwe        user       1551744 May 31 17:17 ghostscript-fonts-4.0.tar.gz
 ...                                                       ...
-rw-rw-r--   1 dwe        user        113342 Jun 16 15:48 wwwstat-2.0.tar.gz
-rw-r--r--   1 richards   user       14154470 Mar 27  1997 xemacs-19.15-common.tar.gz
-rw-r--r--   1 richards   user       2171523 Mar 28  1997 xemacs-19.15-hppa1.1-hp-hpux10.20.tar.gz
-rw-rw-r--   1 dwe        user        435054 May 28 14:29 zip21.zip

Note that:

some packages actually come in more than one tarfile (eg. bash and bash-doc)
More than one version of a package's tarfile can be present but not installed in the pkg directory (eg. apache 1.2beta10 and apache 1.2.1). There is no strong correlation between the package tarfiles and the package directories, except that we always try to keep the tarfile for the published version (and the latest version, if different). In practice, we keep the tarfiles longer than the untarred directories, mostly for the purpose of conserving storage space.
Some of the tarfiles are not actually sources (eg. xemacs). These usually contain and create the installation directories directly.

Here is the site directory in its entirety:

$ ls -l /net/srvr01/_c/opt.10/site
total 18
drwxrwsr-x   3 dwe        user          1024 Aug 18 12:11 CCaseInfo-1.0
drwxrwsr-x   3 dwe        user          1024 Jun 30 13:46 DECserver-1.0
drwxrwsr-x   4 dwe        user          1024 Jul  2 16:39 DECserver-1.1
drwxrwsr-x   5 richards   user          1024 Nov  4 12:47 bern-5.0
drwxrwsr-x   3 richards   user          1024 Jul  2 12:00 repln-0.1
drwxrwsr-x   3 richards   user          1024 Aug  1 10:22 repln-0.2
lrwxrwxr-x   1 dwe        user             4 Sep 17 11:22 se -> se60
drwxrwsr-x   3 dwe        user          1024 Sep 18 15:10 se60

Some slight differences here:

Not all directories have the same naming convention as the pkg directories (eg. se and se60). This is the result of historical pressure placed on locally developed code.
There is no archives directory. The source for these packages is stored elsewhere, in a configuration management system's repository.
There are far fewer packages here than in pkg. That's because our tools group is less prolific than the combined thousands of programmers across the net.

Jump back to top

A Typical Application Directory

Here's a peek into the directory of a typical application, in this case the lynx web browser:

$ ls -l /net/srvr01/_c/opt.10/pkg/lynx-2.7
total 20
-rw-rw-r--   1 dwe        user          5138 Jun  3 12:21 Notes
drwxrwxr-x   2 dwe        user          1024 Jun  2 13:46 bin
drwxrwxr-x   2 dwe        user          1024 Jun  2 13:46 lib
drwxrwxr-x  10 dwe        user          1024 Jun  1 06:59 lynx2-7
drwxrwxr-x   3 dwe        user          1024 May 30 06:45 man

Noteworthy here:

The Notes file. This is a text description of what we did to the package to get it to build under HP-UX. The file was created on behalf of the InterWorks FAST project, and will probably be called README.FAST in the future.
The installation directories:
- bin
- lib
- man
These contain the actual installed files of the application. You knew they had to be around here somewhere!
The source directory lynx2-7. This is the top-level directory in the distribution tar file.

And to finish off the tour, here are listings of the subdirectories of the lynx-2.7 application directory:

$ ls -l /net/srvr01/_c/opt.10/pkg/lynx-2.7/bin
total 1632
-r-xr-xr-x   1 dwe        user        826439 Jun  2 13:45 lynx

$ ls -l /net/srvr01/_c/opt.10/pkg/lynx-2.7/lib
total 128
-r--r--r--   1 dwe        user         65531 Jun  2 13:45 lynx.cfg

$ ls -l /net/srvr01/_c/opt.10/pkg/lynx-2.7/man
total 2
drwxrwxr-x   2 dwe        user          1024 Jun  2 13:45 man1

$ ls -l /net/srvr01/_c/opt.10/pkg/lynx-2.7/man/man1
total 26
-r--r--r--   1 dwe        user         12865 Jun  2 13:45 lynx.1

$ ls -l /net/srvr01/_c/opt.10/pkg/lynx-2.7/lynx2-7 
total 3268
-rw-r--r--   1 dwe        user         48588 Feb 15  1997 CHANGES
-rw-r--r--   1 dwe        user         18114 Jan 15  1996 CHANGES2-3
-rw-r--r--   1 dwe        user         48390 Jan 15  1996 CHANGES2-4
-rw-r--r--   1 dwe        user         93256 Sep  2  1996 CHANGES2-5
-rw-r--r--   1 dwe        user         41847 Sep  2  1996 CHANGES2-6
-rw-r--r--   1 dwe        user          1178 Feb 20  1995 CMU.announce
-rw-r--r--   1 dwe        user          5978 Oct 22  1996 CRAWL.announce
-rw-r--r--   1 dwe        user           664 Nov 25  1996 DESC
-rw-r--r--   1 dwe        user          3655 May 25  1994 FM.announce
-rw-r--r--   1 dwe        user          7674 Aug 29  1996 IBMPC-charsets.announce
-rw-r--r--   1 dwe        user         18767 Feb  9  1997 INSTALLATION
-rw-r--r--   1 dwe        user         29397 Feb 12  1997 LYMessages_en.h
-rw-r-----   1 dwe        user         41200 May 30 06:01 Makefile
-rw-r--r--   1 dwe        user         41160 Feb 15  1997 Makefile.original
-rw-r--r--   1 dwe        user          6522 Feb  6  1997 PROBLEMS
-rw-r--r--   1 dwe        user          4344 Nov 26  1996 README
-rw-r--r--   1 dwe        user          1199 Feb  3  1997 RELEASE_STATEMENT
-rw-r--r--   1 dwe        user          1704 Aug 28  1996 SOCKETSHR.announce
-rw-r--r--   1 dwe        user          1352 Jun  9  1994 TCPWARE.announce
-rw-r--r--   1 dwe        user           616 Jan 10  1996 VMSPrint.com
-rw-r--r--   1 dwe        user          1549 Jun  9  1994 VMSWAIS.announce
drwxrwxr-x   3 dwe        user          1024 May 30 05:58 WWW
drwxrwxr-x   2 dwe        user          1024 May 30 05:58 about_lynx
-rw-r--r--   1 dwe        user          8432 Feb 14  1997 build-slang.com
-rw-r--r--   1 dwe        user          7376 Jan 16  1997 build.com
-rw-r--r--   1 dwe        user          3640 Feb  9  1996 descrip.mms
drwxrwxr-x   2 dwe        user          1024 May 30 05:58 docs
-rw-r--r--   1 dwe        user          1726 Aug 15  1995 fixed512.com
-rwxrwxr-x   1 dwe        user        941127 Jun  2 13:42 lynx
-rw-r--r--   1 dwe        user         65531 Jun  1 06:31 lynx.cfg
-rw-r--r--   1 dwe        user         65549 Feb 14  1997 lynx.cfg.original
-rw-r--r--   1 dwe        user         13215 Feb  3  1997 lynx.hlp
-rw-r--r--   1 dwe        user         12865 Feb  3  1997 lynx.man
drwxrwxr-x   3 dwe        user          1024 May 30 05:58 lynx_help
drwxrwxr-x   2 dwe        user          1024 May 30 05:58 samples
drwxrwxr-x   2 dwe        user          2048 Jun  2 13:47 src
drwxrwxr-x   2 dwe        user          1024 May 30 05:58 test
-rw-r--r--   1 dwe        user         50481 Jun  1 09:05 userdefs.h
-rw-r--r--   1 dwe        user         50502 Feb 14  1997 userdefs.h.original
drwxrwxr-x   4 dwe        user          1024 May 30 05:58 utils

And there they are, the actual files of the application, including the source. Well, the actual sources are in the src subdirectory of lynx2-7, but that was the author's choice, not ours. We do not re-arrange the distribution directories unless we have no other choice.

Jump back to top

Last modified: Thu 6 Nov 1997

Option Directories -- Example

The Workstation

Convenience Directories

The /opt On the Master

The Actual Master opt Directory

The pkg and site Directories

A Typical Application Directory

The `/opt` On the Master

The Actual Master `opt` Directory

The `pkg` and `site` Directories