OpenSolaris

  subsites   code review   repo   packages   bugs   defect   polls   planet
You are not signed in. Sign in or register.

Announcements

This is the default content for the Announcements page. If you are a project leader, click "Edit this page" to change this content.

Heads Up: Flag Day (CIFS Service) | 10/26/2007

To: onnv-gate at onnv dot eng dot sun dot com Subject: Heads Up: Flag Day (CIFS Service)

PSARC 2006/715 CIFS Service CR 6617183

The Common Internet File System (CIFS), also known as SMB, is the standard for Microsoft file sharing services. The Solaris CIFS Service provides the file sharing and MSRPC administration services required for Windows- like behavior for interoperability with CIFS clients. This putback also includes numerous other enhancements to support an integrated set of CIFS file sharing services and technologies (see PSARC 2006/715 for associated PSARC cases).

Heads Up and Flag Day Announcements

  1. VFS and file system changes
  2. Samba and the NetBIOS and SMB ports
  3. CIFS Service
  1. VFS and file system changes

Numerous interface changes have been made at the VFS layer to support CIFS semantics. All ON file systems have been updated to the new interface. In addition, ZFS and NFS have been modified to support CIFS semantics.

Do not use file system kernel modules compiled on a previous build of Solaris. Attempts to load a file system with an older (non-CIFS enabled) interface will result in a failure to load that module and the following message will appear at the console:

    WARNING: file system 'xxx' version mismatch

Where 'xxx' is the name of the file system.

Most of the file system commands (ls, cp, chmod, and tar) have already been modified to accommodate these changes. The pax and cpio commands have not yet been modified and will simply ignore the new Windows-style attributes. Please see the following PSARC cases for further details:

PSARC 2007/124 Strong Type-Checking for VFS Operation Registration
Mechanism
PSARC 2007/218 callercontextt in all VOPs
PSARC 2007/227 VFS Feature Registration and ACL on Create
PSARC 2007/244 ZFS case-insensitive support
PSARC 2007/268 Support for CIFS share reservations
PSARC 2007/315 Extensible Attribute Interfaces
PSARC 2007/403 Modified Access Checks for CIFS
PSARC 2007/440 nbmand changes for CIFS Service
PSARC 2007/394 ls(1) new command line options '-/' and '-%': CIFS system
attributes support
PSARC 2007/410 Add system attribute support to chmod(1)
PSARC 2007/432  CIFS system attributes support for cp(1), pack(1),
unpack(1), compress(1) and uncompress(1)
PSARC 2007/459  CIFS system attributes support for cpio(1), pax(1), 

tar(1)


    

  1. Samba and the NetBIOS and SMB ports
    2.

The NetBIOS and SMB ports are now protected with a new privilege: syssmb, which is similar to sysnfs. The syssmb privilege is required to bind to ports 137, 138, 139 and/or 445. Dependent on how Samba is launched, a change may be required to bind to these ports. See the smb/server manifest for details of how the CIFS service is started.

Also, not that use of Samba and the CIFS service is mutually exclusive on a system, since both attempt to bind to the same ports.

  1. Using the CIFS Services

The initial integration of the Solaris CIFS service supports both workgroup and domain modes, and provides a comprehensive CIFS file sharing service implementation. For the highest level of CIFS interoperability, use ZFS in mixed casesensitivity mode (see PSARC 2007/244). This will retain the expected behavior for local and NFS access whilst maximizing inter- operability with Windows, MacOS and other CIFS clients. Note that the casesensitivity mode of a ZFS file system must be set at creation time and cannot be changed after creation.

This is a phased project and there are limitations at this time:

Partial support for SPARC platforms.  File sharing is available on
SPARC but not all MSRPC services are available.  Parity across x86
and SPARC is expected follow within 30 days.
Support for NT4.0 domains requires additional integration with other
services in Solaris.  Active Directory domains are supported, as is
Workgroup mode, which allows use of Solaris CIFS in a NIS environment
without any Windows domain infrastructure.
Cross-protocol mandatory file lock integration is not yet complete.
NFS and CIFS are self-consistent but it is still possible to access
a file via NFS that has been locked by a CIFS client.  The ARC cases
to support full cross-protocol lock integration have been approved
and are included with this putback.  Integration will be completed in
phase 2 of the CIFS project.
CIFS print services are not included in this release.

A preliminary draft of System Administration Guide: Windows Interoperability for the Solaris OS will be available in the near future on the Solaris CIFS server project page at OpenSolaris.org (available soon). The following man pages are being prepared (also available in the PSARC 2006/715 materials).

sharctl(1M)
sharemgr(1M)
smbadm(1M)
smbd(1M)
smbstat(1M)
smb(4)
smbautohome(4) (man page may appear as smbautohome initially)

Bugster Categories

solaris/kernel/cifs     CIFS server kernel
solaris/utility/cifs      CIFS server user land