Content-type: text/html Manpage of Sregister

Sregister

Section: User SRB Commands (1)
Updated: Jan 2002
Index Return to Main Contents
 

NAME

Sregister - registers one or more files into SRB space.  

SYNOPSIS

Sregister [-p] [-D dataType] [-S size] [-R resourceName] RegisteringObjectPath ... TargetName
Sregister -c [-p] [-D dataType] [-S size] [-R resourceName] RegisteringObjectPath srbObjectName  

DESCRIPTION

Sregister registers files that are created outside SRB but are accesible by SRB and are as yet unregistered). The files are not modified. The options are similar to that of Sput.

The RegisteringObjectPath can be a path name in the local file hierarchy. SRB should have at least 'read/write' access permission for RegisteringObjectPath. This is required as a security measure that objects are registered only by owners who are able to grant SRB write priveleges. One can always remove the 'write' permission once the object has been registered. Note that without write permission, SRB cannot write, append or remove the object.

RegisteringObjectPath can be a pattern in the case of Unix.

The second synopsis allows one to register another copy of an already existing (or registered) srbObjectName at the new location RegisteringObjectPath.

The TargetName can be a path name in the collection hierarchy. The object creation is done in the current collection, if TargetName is just an object-name. If a relative or absolute collection is given in TargetName, then the object is stored in that collection. The user should have 'write' access permission for the collection. '.' can be used as TargetName to denote the current collection.

If TargetName is a collection, then Sregister uses the names of the local files as SRB object names. The directory path of RegisteringObjectPath is not used in making the SRB object name.

If TargetName is an object-name (possibly with a collection path) and there are more than one local file to be copied then the TargetName is appended to the front of the local file names to make SRB object names.

If given, the data type of the object is set to dataType. Otherwise, Sregister uses the file extender (i.e. string after the last '.') to figure out the type. If it is unable to figure out the data type, the 'generic' data type is used. Most popular extenders in Unix and DOS will be supported. The data type discovery is done in the MCAT and hence future extenders can be supported without any change in or compilation of the client code.

If given, the object is stored in resourceName. Otherwise the object is stored in the default resource given by DEFRESOURCE in the user environment file, located in ~/.srb/.MdasEnv

The size parameter is needed for correct operations of many other Scommands. Hence we suggest that you give the correct size of the file using this option. If the size is not given, it will try to get it through a stat() call assuming the file is local. If this stat() failed, a value of 0 is chosen.

 

OPTIONS

-h
display command options
-p
prompts before writing each object to SRB space.
-c
registers another copy of an existing SRB object.
 

SEE ALSO

Sput(1)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 18:44:15 GMT, July 02, 2004