Graphics Files Display from LXR

If your source tree contains graphics files (icons, pictures, ...) and you want to display them with your browser (within the limits of the formats your browser understands), you need to make your source tree visible according to the standard access rules of the web server.

Two sets of rules must be considered:

• Server rules

  When you configured LXR (preconfigured for releases prior to 1.0) or configured the web server web (0.11 or prior releases) with Alias and Directory, you made the LXR root directory visible by the server and no other directory.

  In particular, your source tree is unknown to the server.
• OS rules

  LXR scripts are executed as an independent process with the usual OS access rules and constraints. Their output only is passed to the server.

What this means is you cannot just put a filename in the URL because there is no server relationship between the LXR root directory and the source tree directory. The only link between both is written in the lxr.conf configuration file in OS terms, not server terms, for OS use.

To bridge this gap, you must create the link in two steps:

1. Force the source tree in the server visibility hierarchy

   Create a symbolic link from the LXR root directory to the source tree

   $ cd LXR_root_directory $ ln -s source_tree_directory source_short_name

   Choose a different source_short_name for every desired source tree.

2. Tell LXR to use the link

   Edit the lxr.conf file. Go to the tree location subsection of the desired tree and, after 'sourceroot' parameter, define:

   , 'sourceaccess' => 'source_short_name' Remember: source_short_name is expressed relative to LXR root directory and used by HTML code. See this page for advice.