Library Table of Contents Index Previous Page (Alt-p) Next Page (Alt-n) Comments

Understanding how CIFS clients interact with symbolic links

Enabling CIFS clients to follow symbolic links  Top

The cifs.symlinks.enable option, enabled by default, permits CIFS clients to follow symbolic links.

To enable CIFS access to symbolic links after they have been disabled, complete the following step:

Step

Action

1

Enter the following command to enable CIFS access to symbolic links:

options cifs.symlinks.enable on

Result

CIFS clients will directly follow relative symbolic links to destinations in the same share.

There are special requirements to enable CIFS access to the following types of symbolic links:

The following section describes the options for setting up the way CIFS clients behave when they encounter relative and absolute symbolic links on the filer.

Ways CIFS clients can interact with symbolic links  Top

You can specify how you want CIFS clients to interact with symbolic links by doing one or more of the following:

Use the following table to help determine which options you want to implement. The table shows for each option the types of destinations that symbolic links will be able to point to.

Symbolic link destination can be...

Options for CIFS access to symbolic links

Map entries

Widelink entries

No share boundary check

The same share on the same filer

X

X

X

Another share on the same filer

 

X

X

A non-shared area of the same filer

 

 

X

A share on another filer

 

X

 

A share on another CIFS server or a desktop PC

 

X

 

For more information about each of these options, see the following sections:

Why you should avoid symbolic links to files  Top

You should prevent CIFS clients from following symbolic links that point to files because Data ONTAP can update the wrong files. The wrong files may be updated because many CIFS client applications perform operations such as writing to a temporary file, renaming the original file to a backup name, then renaming the temporary file to the original name.

When client applications perform these operations, if the original file was targeted directly by a symbolic link, that file would be stored in the directory where the symbolic link was, and the renamed symbolic link would point to the original file rather than to the updated file.

Note
CIFS clients following symbolic links to directories, rather than to individual files, do not experience this problem.

Library Table of Contents Index Previous Page (Alt-p) Next Page (Alt-n) Comments