Skip to main content

vserver cifs symlink show

Contributors
Suggest changes
PDFs

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.