Release Contents

The Shore Software distribution consists of documentation, binary, and source releases. These are briefly described below. Additional information is available in the installation manual.

 

Documentation Release

The documentation release consists of HTML and Postscript versions (in docs.html/ and docs.ps/, respectively) of about 15 documents and over 150 manual pages. It also contains, in the examples directory, source code for several example programs.

• The Shore Release 1.1.1 (this document)
• Shore Software Installation Manual
• How to Submit a Problem Report
• An Overview of Shore
• Glossary of Shore Terms
• Documents for Users of SDL and the Shore Server
  • A list of all the manual pages
  • Configuring and Running the Shore Server
    and related manual pages:
    • options(SVAS)
    • environment(SVAS)
    • sshutdown(SVAS)
    • mount(SVAS)
    • smount(SHORE)
  • A tutorial on writing Shore applications using the Shore Data Language (SDL) Getting Started with Shore
    and miscellaneous helpful documents:
    • Scanning Directories
    • Scanning Pools
    • Handling Errors
  • Shore Data Language Reference Manual
    and related manual pages:
    • Manual pages for using the SDL compiler and the SDL C++ language binding,
    • Manual pages for the Shore Object Cache and Unix-compatibility classes
• Documents for Value-Added Server Writers (using the Storage Manager)
  • A Roadmap to the Shore Releases
  • The Shore Storage Manager Programming Interface
  • Manual Pages for the Storage Manager
    • Storage Manager proper
    • Foundation classes
    • Thread package
    • Common utility classes
  • Writing Value-Added Servers with the Shore Storage Manager a tutorial on using the Storage Manager

The example programs in the examples directory include

stree

examples to go with the tutorial Getting Started with Shore,

pscan

an example to go with the tutorial Scanning Pools,

shls

an example to go with the tutorial Scanning Directories,

unixfile

some examples that use the type SdlUnixFile, which is a registered object with one attribute, of type text (the object looks like a Unix file),

vas/hello

a trivial "value-added server,"

vas/grid

a much more extensive value-added server, described in the tutorial Writing Value-Added Servers with the Shore Storage Manager, and

oo7

an implementation of the OO7 Benchmark .

 

Binary Release

A binary release consists of the SDL compiler, a run-time library to be linked with applications, the Shore Server executable, and utilities for mounting the Shore File System as an NFS file system. It also includes the libraries and header files for the Shore Storage Manager. The binary release is available with and without internal debugging support. The differences between the two are as follows:

• Debugging release:
  • Compiled with debugging symbols (-g)
  • Compiled with extra auditing/debugging (-DDEBUG)
  • Compiled with simple optimization (-O)
  • Executables are considerably larger and slower than their no-debugging counterparts.
• No-Debugging release:
  • Compiled without debugging symbols
  • Compiled without extra auditing/debugging (-UDEBUG)
  • Compiled with more optimization (-O2)

 

Source Release

The source release contains the source tree and tools for building everything in the binary release.