man page(1) manual page

NAME

cifs shares - configure and display CIFS shares information

SYNOPSIS

cifs shares

cifs shares sharename

cifs shares -add sharename path
[ -comment description ]
[ -maxusers userlimit ]
[ -forcegroup groupname ]

cifs shares -change sharename
{ -comment description | -nocomment }
{ -maxusers userlimit | -nomaxusers }
{ -forcegroup groupname | -noforcegroup }

cifs shares -delete sharename

DESCRIPTION

cifs shares displays one or more shares, edits a specified share, creates a share, or deletes a share.

Listing shares

To list all shares and their access control lists, use the command cifs shares with no arguments. To list a single share and its access control list, use the command cifs shares sharename where sharename name of the share.

toaster> cifs shares

  Name              Mount Point             Description
  ----              -----------             -----------
  HOME              /vol/vol0/home          Default Share
                            everyone / Full Control
  C$                /vol/vol0               Remote Administration
                            BUILTIN\Administrators / Full Control
  ENGR              /vol/vol0/engr          Engineering
                            DOMAIN\Engineering / Full Control
  NEWS              /vol/vol0/news          News
                            DOMAIN\Guests / No Access
                            everyone / Read

toaster> cifs shares news

  Name              Mount Point             Description
  ----              -----------             -----------
  NEWS              /vol/vol0/news          News
                            DOMAIN\Guests / No Access
                            everyone / Read

Creating new shares

To create a new share, use the -add option:

cifs shares -add sharename path
[ -comment description ]
[ -maxusers userlimit ]
[ -forcegroup groupname ]

sharename name of the new share; clients use this name to access the share.

path: full path name of the directory on the filer that corresponds to the root of the new share.

-comment description
description of the new share. CIFS clients see this description when browsing the filer's shares. If the description includes spaces, it must be enclosed in double quotatation marks. If you do not specify a description, the description is blank.

-maxusers userlimit
maximum number of simultaneous connections to the new share. userlimit must be a positive integer. If you do not specify a number, the filer does not impose a limit on the number of connections to the share.

-forcegroup groupname
name of the group to which files to be created in the share belong. The groupname is the name of a group in the UNIX group database.

Deleting existing shares

To delete a share, use the -delete option:

cifs shares -delete sharename

sharename is the name of the share to be deleted. A share cannot be deleted if it is in use.

Changing the settings of existing shares

To change the settings of an existing share, use the -change option:

cifs shares -change sharename
{ -comment description | -nocomment } { -maxusers userlimit | -nomaxusers } { -forcegroup groupname | -noforcegroup }

The settings of a share can be changed at any time, even if the share is in use.

sharename is the name of the existing share that is to be changed.

-comment description
changes the description of the share. For more information about the share description setting, see the Creating new shares section, above.

-nocomment changes the description of the share to an empty string.

-maxusers userlimit
changes the user limit on the share. For more information about the user limit setting, see the Creating new shares section, above.

-nomaxusers removes the user limit on the share.

-forcegroup groupname
changes the forcegroup setting. For more information about the forcegroup setting, see the Creating new shares section, above.

-noforcegroup
specifies that files to be created in the share do not belong to a particular UNIX group. That is, each file belongs to the same group as the owner of the file.

NAME

SYNOPSIS

DESCRIPTION

SEE ALSO