2009/139 CIFS CATIA Translation Share Property

[Jordan Brown]

I am sponsoring the following for fast track approval.  The timer
expires Wednesday 4 March 2009.

Note:  This message contains non-ASCII characters, encoded (if I've
gotten the Thunderbird settings right) in UTF-8.  Unicode hex equivalents
are provided for non-UTF-8-capable readers.

This information is Copyright 2009 Sun Microsystems

1. Introduction
      1.1. Project/Component Working Name:
           CATIA translation share property
      1.2. Name of Document Author/Supplier:
           Author:  Joyce McIntosh
      1.3  Date of This Document:
           25 February, 2009

4. Technical Description

	4.1 Details:

	This fast-track proposes a new property for shares to support
	character translation of filenames for CATIA.

	CATIA V4 is a UNIX product and uses characters in filenames that
	are considered invalid by Windows. CATIA V5 is available on both
	UNIX and Windows. Thus, as CATIA customers migrate from V4 to V5,
	a V4 file could become inaccessible to windows clients if the
	filename contains the characters that are considered illegal in
	Windows.  In order to address this issue an optional character
	translation, as defined in the table below, is applied to filenames
	within the SMB server. This character translation policy is a de
	facto standard on platforms that support multi-protocol (NFS and
	SMB) file sharing.

	CATIA V4 UNIX	CATIA V5 Windows
	    "		  ¨	0x00a8 Dieresis
	    *		  ¤	0x00a4 Currency Sign
	    /		  ø	0x00f8 Latin Small Letter O with Stroke
	    :		  ÷	0x00f7 Division Sign
	    <		  «	0x00ab Left-Pointing Double Angle Quotation Mark
	    >		  »	0x00bb Right-Pointing Double Angle Quotation Mark
	    ?		  ¿	0x00bf Inverted Question Mark
	    \		  ÿ	0x00ff Latin Small Letter Y with Dieresis
	    |		  ¦	0x00a6 Broken Bar
	

	The proposed catia property will control whether or not this
	catia character translation is performed.

	The proposed catia property can take one of values described below.

	catia=true|false

	true

	CATIA filename character substitution will be performed for this share.

	false

	CATIA filename character substitution will not be performed for
	this share. This is the default value.


	Examples of setting the catia property using the sharemgr and zfs
	commands:

		sharemgr set -P smb -p catia=true -r zshare zgroup

		zfs sharesmb=catia=true tank/zvol

	4.2. Bug/RFE Number(s)		
	6582159 CATIA support

	4.6. Doc Impact:
	CIFS Administration Guide

	Modifications to sharemgr(1M) man page:
	-------------------------------------------------------------------
	The general properties supported for SMB are:

+	catia=boolean
+
+	CATIA V4 uses characters in filenames that are considered invalid
+       by Windows. CATIA V5 is available on Windows. A CATIA V4 file could
*	be inaccessible to windows clients if the filename contains any of
+	the characters that are considered illegal in Windows.
*	If the catia property is set to true, the following character
*	substitution is applied to filenames.
+
+	CATIA V4 UNIX	CATIA V5 Windows
+	  "		  ¨	0x00a8	Dieresis
+	  *		  ¤	0x00a4	Currency Sign
+	  /		  ø	0x00f8	Latin Small Letter O with Stroke
+	  :		  ÷	0x00f7	Division Sign
+	  <		  «	0x00ab	Left-Pointing Double Angle Quotation Mark
+	  >		  »	0x00bb	Right-Pointing Double Angle Quotation Mark
+	  ?		  ¿	0x00bf	Inverted Question Mark
+	  \		  ÿ	0x00ff	Latin Small Letter Y with Dieresis
+	  |		  ¦	0x00a6	Broken Bar
+

      ro=access-list

          Sharing is read-only to the clients  listed  in  access-
          list;  overrides the rw suboption for the clients speci-
          fied. See the description of access-list below.
	-------------------------------------------------------------------
	
6. Resources and Schedule
      6.4. Steering Committee requested information
     	6.4.1. Consolidation C-team Name:
		ON
      6.5. ARC review type: FastTrack
      6.6. ARC Exposure: open