Skip to main content

vserver cifs symlink show

Show symlink path mappings

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description​

The vserver cifs symlink show command displays the following information about symbolic link mappings for CIFS:

  • Vserver

  • UNIX (NFS) path

  • The DNS name, IP address, or NetBIOS name of the CIFS server

  • CIFS share name

  • CIFS path

  • Whether the locality of the CIFS server is a local, free, or wide link. (A local symbolic link maps to the local CIFS share. A free symbolic link can map anywhere on the local server. A wide symbolic link maps to any CIFS share on the network. The free link option is deprecated and may be removed in a future release of Data ONTAP.)

Parameters​

{ [-fields <fieldname>, ...]
If you specify the -fields <fieldname>, ... parameter, the command only displays the fields that you specify.
| [-instance ]}
If you specify the -instance parameter, the command displays detailed information about all entries.
[-vserver <vserver name>] - Vserver
If you specify this parameter, the command displays information about symbolic link mappings on the specified Vserver.
[-unix-path <text>] - UNIX Path
If you specify this parameter, the command displays information only about the symbolic link mapping that uses the specified UNIX (NFS) path.
[-share-name <Share>] - CIFS Share
If you specify this parameter, the command displays information only about the symbolic link mapping or mappings that use the specified CIFS share.
[-cifs-path <TextNoCase>] - CIFS Path
If you specify this parameter, the command displays information only about the symbolic link mapping that uses the specified CIFS path.
[-cifs-server <TextNoCase>] - Remote NetBIOS Server Name
If you specify this parameter, the command displays information only about the symbolic link mapping that uses the specified CIFS server.
[-locality {local|widelink}] - Local or Wide Symlink
If you specify this parameter, the command displays information only about the symbolic link mappings that have the specified locality.
[-home-directory {true|false}] - Home Directory
If you specify this parameter, the command displays information only about the symbolic link mappings that have the target share as a home directory (if true) or as a static CIFS share (if false).

Examples​

The following example displays information about all symbolic link mappings for CIFS:

cluster1::> vserver cifs symlink show
Vserver    Unix Path  CIFS Server         CIFS Share  CIFS Path          Locality
---------- ---------- ------------------- ----------- ------------------ --------
vs1        /hr/       192.0.2.160         HR_SHARE    /mycompany/hr/     widelink
vs1        /sales/    WINDATA             SALES_SHARE /mycompany/sales/  local
vs1        /web/      cifs.example.com    WEB_SHARE   /mycompany/web/    widelink
3 entries were displayed.

The following example displays information about all symbolic link mappings that are wide links:

cluster1::> vserver cifs symlink show -locality widelink
Vserver    Unix Path  CIFS Server         CIFS Share  CIFS Path       Locality
---------- ---------- ------------------- ----------- --------------- --------
vs1        /hr/       192.0.2.160         HR_SHARE    /mycompany/hr/  widelink
vs1        /web/      cifs.example.com    WEB_SHARE   /mycompany/web/ widelink
2 entries were displayed.