Return to Filing6d.n CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / xns / man

Annotation of 43BSDTahoe/new/xns/man/Filing6d.n, revision 1.1

1.1     ! root        1: .TH "FILING6D" 1 "3-Feb-87" "Xerox (WRC)"
        !             2: .\" $Header: Filing6d.n,v 1.2 87/04/01 13:54:28 ed Exp $
        !             3: .SH NAME
        !             4: Filing6d - XNS Filing version 6 service
        !             5: .SH DESCRIPTION
        !             6: .I Filing6d
        !             7: is a service for the XNS Courier Filing protocol version 6.
        !             8: This service implements a subset of the Filing Protocol which is similar
        !             9: to the XNS FilingSubset Protocol; however, extensions to this subset
        !            10: provide additional functionality more closely aligned with full Filing
        !            11: functionality.
        !            12: .PP
        !            13: The service is forked from the XNS courier daemon,
        !            14: .IR xnscourierd , 
        !            15: upon connection requests for version 6 of the Filing Protocol.
        !            16: .SH "PROCEDURE SUPPORT"
        !            17: The Filing Protocol defined procedures 
        !            18: .IR Logon , 
        !            19: .IR Logoff , 
        !            20: .IR Continue , 
        !            21: .IR Open , 
        !            22: .IR Close ,
        !            23: .IR Create ,
        !            24: .IR Delete ,
        !            25: .IR GetAttributes ,
        !            26: .IR ChangeAttributes ,
        !            27: .IR Copy ,
        !            28: .IR Move ,
        !            29: .IR Store ,
        !            30: .IR Retrieve ,
        !            31: .IR Replace ,
        !            32: .IR Serialize ,
        !            33: .I Deserialize
        !            34: and
        !            35: .I List
        !            36: are supported. The extent of support is
        !            37: consistent with the FilingSubset Protocol with extensions added to provide
        !            38: additional functionality and interoperability.
        !            39: .SH "ATTRIBUTE SUPPORT"
        !            40: Attribute support within the service is also consistent with the FilingSubset
        !            41: Protocol. All attributes defined as mandatory in the FilingSubset Protocol
        !            42: are supported (\fIcreatedOn\fR, 
        !            43: .IR dataSize , 
        !            44: .IR isDirectory , 
        !            45: .IR modifiedOn , 
        !            46: .IR pathname, 
        !            47: .IR type ).
        !            48: Additional attributes (\fIcreatedBy\fR, 
        !            49: .IR fileID , 
        !            50: .IR name ,
        !            51: .IR readOn , 
        !            52: .IR version)
        !            53: are supported
        !            54: and/or allowed to provide interoperability. 
        !            55: .PP
        !            56: Additional Viewpoint related attributes are uninterpreted by the 
        !            57: file service; however, they are retained and returned to the client when
        !            58: retrieved.
        !            59: .PP
        !            60: The \fIOpen\fR procedure allows files to be identified through the use of the
        !            61: .IR fileID ,
        !            62: .I name
        !            63: or 
        !            64: .I pathname
        !            65: attributes.
        !            66: .PP
        !            67: .I Filing6d
        !            68: maintains the file type attribute in a manner consisten with the storage of
        !            69: the file locally. Files are stored locallay as described in 
        !            70: \fIViewpointfiles(5N)\fR. Uninterpreted attributes are
        !            71: retained with the file content so that they may be returned when asked for.
        !            72: .PP
        !            73: Since the service does not maintain the file types explicitly within the Unix
        !            74: file system
        !            75: .I Filing6d
        !            76: will make an educated guess of the file type based on the contents and/or
        !            77: stored attributes of the file, when a client requests the type of a file.
        !            78: .SH "FILE TRANSFERS"
        !            79: .I Filing6d
        !            80: currently makes a distinction between  
        !            81: .I tText 
        !            82: and other file types for use during file transfer. Files of type
        !            83: .I tText
        !            84: undergo a translation of contents for compatibility with existing Filing
        !            85: implementations; Unix EOL characters
        !            86: (\\n) are translated to and from Xerox EOL characters (\\r), Xerox left
        !            87: arrow characters are translated to underscore, etc.
        !            88: All other files are treated as a binary stream with no translation incurred.
        !            89: .SH AUTHENTICATION
        !            90: The Filing Protocol allows clients to specify both primary and secondary
        !            91: credentials.
        !            92: .I Filing6d
        !            93: allows specific combinations of these credentials and accompanying verifier
        !            94: and performs the authentication based on the type supplied. Clients may
        !            95: specify 
        !            96: .IR simple ,
        !            97: .I strong
        !            98: or
        !            99: .I nullCredentials
        !           100: as the primary credentials. If
        !           101: .I simple 
        !           102: credentials are supplied, the credentials and verifier will be validated with
        !           103: a network Authentication service. 
        !           104: .I nullCredentials
        !           105: and 
        !           106: .I strong
        !           107: credentials will effectively be allowed with no network authentication.
        !           108: .PP
        !           109: Regardless of the type of primary credentials, clients are required to
        !           110: supply a set of 
        !           111: .I simple
        !           112: secondary credentials consisting of the types
        !           113: .I userName
        !           114: and
        !           115: .IR userPassword .
        !           116: These will contain the user's Unix user name and password and are used by
        !           117: .I Filing6d
        !           118: to validate the user on the host system. Failure to supply these will result
        !           119: in an Authentication error being returned to the client.
        !           120: .SH "SEE ALSO"
        !           121: Filing4d(1N), Filing5d(1N), FilingSubset1d(1N)
        !           122: .br
        !           123: Filing Protocol, \s8XNSS\s0 108507 (July 1985)
        !           124: .br
        !           125: Filing Protocol, \s8XNSS\s0 108605 (May 1986)
        !           126: .br
        !           127: FilingSubset Implementor's Guide, \s8XNSG\s0 098609 (September 1986)
        !           128: .SH NOTES
        !           129: A limited subset of the full Filing Protocol is actually implemented.
        !           130: Procedures dealing with controls, access lists or random access are not yet
        !           131: implemented.
        !           132: .PP
        !           133: .I ChangeAttributes
        !           134: only allows the \fIname\fR attribute to be modified.
        !           135: .PP
        !           136: Service related attributes (\fIaccessList\fR,
        !           137: .IR checksum ,
        !           138: .IR childrenUniquelyNamed ,
        !           139: .IR defaultAccessList ,
        !           140: .IR numberOfChildren ,
        !           141: .IR ordering ,
        !           142: .IR parentID ,
        !           143: .IR position ,
        !           144: .IR subtreeSize ,
        !           145: .IR subtreeSizeLimit )
        !           146: are not implemented within this service.
        !           147: .PP
        !           148: .I tAsciiText
        !           149: files are currently not implemented. Files of this type are currently 
        !           150: transferred as 
        !           151: .I tText 
        !           152: files with the translation specified above used to insure compatibility with
        !           153: existing Filing implementations.
        !           154: .SH BUGS
        !           155: Like all other server implementations in the Unix/XNS environment a single
        !           156: Filing session is not allowed to exist over multiple transport (SPP) 
        !           157: connections.
        !           158: .SH AUTHOR
        !           159: Ed Flint

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.