The clearfsimport command reads the specified file system source objects and places them in the target VOB. This command uses magic files to determine which element type to use for each element created (see the cc.magic reference page). The source and target directories may not be the same; to create an element from a view-private object that already resides in the target directory, use mkelem.
You must be root (UNIX) or the VOB owner to run clearfsimport unless you invoke it with the -nsetevent option.
If it encounters a VOB lock while trying to write data during an import operation, clearfsimport pauses and retries the operation every 60 seconds until it succeeds.
(Replicated VOBs only) Your current replica must master the branch types, branches, elements, and type objects involved in the import. With the –master option, the importer can create a new element and its main branch even if the main branch is not mastered by your current replica. The –master option also allows auto-make-branch during element creation; mastership of newly created branches is assigned to the current replica. When you specify the –master option, you must be able to check out the parent directory of the new element.
Because Windows prohibits renaming a directory that is in use, you cannot run clearfsimport in a snapshot view on Windows if the current working directory is also the target-VOB-directory.
OPTIONS AND ARGUMENTS
Previewing the Results
Handling of UNIX Symbolic Links
Handling of Directory Arguments
Handling of Existing VOB Directories
- Existing VOB directories that are
not present in the sources to be imported are left as is.
- For all source-name arguments
that are directories, performs an rmname operation
on elements that are already in the VOB but are not present in the source
directory. If used in combination with -recurse, performs
this rmname operation in all directories
traversed. If used in combination with -downcase, performs
the downcase operation before looking for
matching names in the VOB.
- Historical information associated
with the sources is preserved.
- Specifies that event records and historical
information for new elements and element versions show the user who executed clearfsimport and
the date of execution, not the original data associated with the sources.
This option creates element versions that are newer than the original sources;
thus, the clearfsimport operation is not restartable after
you have invoked it with this option.
Creation of Identical Successor Versions
Handling of Existing Checked-Out Elements
- When clearfsimport encounters
a checked-out element that exists in the target VOB and corresponds to a source
to be imported, it prints an error and continues.
- If a checked-out file element that
corresponds to a source file to be imported exists in the target VOB, an uncheckout operation is executed on the element
and the corresponding view-private file is retained with a suffix of .keep.
The import operation then checks out the element again and checks in the imported
Handling of Case of Imported Elements
- Case preserving.
- Changes names of imported elements
Note: When importing files from a UNIX host into a VOB on a Windows NT host, clearfsimport may be unable to operate correctly on files and directories that have mixed-case names. For example, if a mixed-case name is specified on the command line, clearfsimport creates the element name as specified, even when the form of the source name is different. Consistent use of -downcase can help avoid these problems. If you specify-downcase for an initial import from UNIX to Windows NT, specify it on any subsequent imports into the same VOB directories.
Specifying the Source
- source-name [. . .]
- Flat files, directories, and UNIX
symbolic links to be imported to the VOB. You can specify pathnames or use
wildcards as described in wildcards_ccase.
For each pathname, the leaf of the pathname is imported into the target VOB. For example, /usr/src/lib/foo.c is imported into the VOB /vobs/mylib as /vobs/mylib/foo.c or into the VOB /bigvob as /bigvob/foo.c.
For each file, an element version is imported. If a corresponding version of the file exists in the target VOB and is checked out, clearfsimport prints and error and continues unless the -unco option was specified. A summary of import failures due to checked-out elements is printed at the completion of the import operation.
For each directory, versions are created for all files and UNIX symbolic links it contains. Also created is a directory element with one version for the directory and each of its subdirectories. Checked-out VOB directories that correspond to source directories to be imported are reused.