Managing ObjectStore

osln: Creating Links in the Rawfs

The osln utility creates a symbolic link in the rawfs hierarchy.

Syntax

osln pathname linkname
pathname 
The pathname of the rawfs directory or database that you want to point to.

linkname 
The pathname of the rawfs directory or database that is the new link. It points to pathname.

Description

Different links can point to the same rawfs pathname.

To indicate hosts, specify pathnames in the form

host::/pathname

Limitation

To access a particular database or directory, a client can follow as many as 15 cross-Server links. For example, a client traverses a link to Server Q. Server Q sends the client to Server P. Server P sends the client to another Server or even back to Server Q. Each connection to a Server counts as one link. It does not matter whether the Server was previously connected to in the link chain. When the client reaches the sixteenth link, ObjectStore signals the error message err_too_many_cross_svr_links.

To access a particular database or directory in its rawfs, the Server can traverse as many as 10 same-Server links. When the Server reaches the 11th link, ObjectStore signals the error message err_too_many_links.

In a chain of links, a client can return to a Server that it contacted earlier in the chain. In this situation, the Server's count of links within its rawfs begins with one. It does not continue the count from where it left off during the previous connection. Each time a link sends the client to a Server, the Server can follow as many as 10 links within its rawfs.

These limits allow ObjectStore to catch circular links. For example, A is a link to B, and B is either directly or indirectly a link to A.

When needed

Links within the rawfs are useful in many situations, including the following:

Removing a link

To remove a link, use the osrm utility. The syntax is osrm linkname.

See osrm: Removing Databases and Rawfs Links.

Examples

In the following example, link_to_db in canard's rawfs points to real_db in web-foot's rawfs.

osln web-foot::/real_db canard::/link_to_db
In the next example, link_to_db points to real_db and both databases are in the same rawfs.

osln web-foot::/real_db web-foot::/link_to_db

API

Class: os_dbutil
Method: make_link



[previous] [next]

Copyright © 1999 Object Design, Inc. All rights reserved.

Updated: 03/11/99 11:19:07