Return to FilingSubset1d.n CVS log

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

Annotation of 43BSDTahoe/new/xns/man/FilingSubset1d.n, revision 1.1.1.1

1.1       root        1: .TH "FILINGSUBSET1D" 1 "30-Dec-86" "Xerox (WRC)"
                      2: .\" $Header: FilingSubset1d.n,v 1.2 87/04/01 13:54:48 ed Exp $
                      3: .SH NAME
                      4: FilingSubset1d - XNS FilingSubset version 1 service
                      5: .SH DESCRIPTION
                      6: .I FilingSubset1d
                      7: is a service for the XNS Courier FilingSubset protocol version 1.
                      8: The implementation adheres to the guidelines for implementations 
                      9: documented in the FilingSubset Implementor's Guide.
                     10: .PP
                     11: The service is forked from the XNS courier daemon,
                     12: .IR xnscourierd , 
                     13: upon connection requests for version 1 of the FilingSubset Protocol.
                     14: .SH "PROCEDURE SUPPORT"
                     15: The Filing Protocol defined procedures 
                     16: .IR Logon , 
                     17: .IR Logoff , 
                     18: .IR Continue , 
                     19: .IR Open , 
                     20: .IR Close ,
                     21: .IR List , 
                     22: .IR Delete ,
                     23: .I Store 
                     24: and 
                     25: .I Retrieve
                     26: are supported. The extent of support is
                     27: consistent with the implementation of the FilingSubset Protocol as
                     28: described in the FilingSubset Implementor's Guide.
                     29: .SH "ATTRIBUTE SUPPORT"
                     30: Attribute support within the service is also consistent with the FilingSubset
                     31: Protocol. All attributes defined as mandatory in the FilingSubset Protocol
                     32: are supported (\fIcreatedOn\fR, 
                     33: .IR dataSize , 
                     34: .IR isDirectory , 
                     35: .IR modifiedOn , 
                     36: .IR pathname, 
                     37: .IR type ).
                     38: .PP
                     39: .I FilingSubset1d
                     40: supports several file types. The FilingSubset defined types, 
                     41: .IR tDirectory , 
                     42: .I tText
                     43: and
                     44: .I tUnspecified
                     45: are allowed as well as the additional Viewpoint types, 
                     46: Interpress and VPCanvas (RES). The latter two are supported only for 
                     47: interoperability and are treated the same as 
                     48: .I tUnspecified
                     49: files during file transfer. 
                     50: Since the service does not maintain the file types explicitly within the Unix
                     51: file system
                     52: .I FilingSubset1d
                     53: will make an educated guess of the file type based on the contents of the
                     54: file, when a client requests the type of a file.
                     55: .SH "FILE TRANSFERS"
                     56: .I FilingSubset1d
                     57: currently makes a distinction between  
                     58: .I tText 
                     59: and other file types for use during file transfer. Files of type
                     60: .I
                     61: tText
                     62: undergo a translation of contents for compatibility with existing Filing
                     63: implementations; Unix EOL characters
                     64: (\\n) are translated to and from Xerox EOL characters (\\r), Xerox left
                     65: arrow characters are translated to underscore, etc.
                     66: All other files are treated as a binary stream with no translation incurred.
                     67: .SH AUTHENTICATION
                     68: The Filing Protocol allows clients to specify both primary and secondary
                     69: credentials.
                     70: .I FilingSubset1d
                     71: allows specific combinations of these credentials and accompanying verifier
                     72: and performs the authentication based on the type supplied. Clients may
                     73: specify 
                     74: .IR simple ,
                     75: .I strong
                     76: or
                     77: .I nullCredentials
                     78: as the primary credentials. If
                     79: .I simple 
                     80: credentials are supplied, the credentials and verifier will be validated with
                     81: a network Authentication service. 
                     82: .I nullCredentials
                     83: and 
                     84: .I strong
                     85: credentials will effectively be allowed with no network authentication.
                     86: .PP
                     87: Regardless of the type of primary credentials, clients are required to
                     88: supply a set of 
                     89: .I simple
                     90: secondary credentials consisting of the types
                     91: .I userName
                     92: and
                     93: .IR userPassword .
                     94: These will contain the user's Unix user name and password and are used by
                     95: .I Filing6d
                     96: to validate the user on the host system. Failure to supply these will result
                     97: in an Authentication error being returned to the client.
                     98: .SH "SEE ALSO"
                     99: Filing4d(1N), Filing5d(1N), Filing6d(1N), ViewpointFiles(5N)
                    100: .br
                    101: Filing Protocol, \s8XNSS\s0 108605 (May 1986)
                    102: .br
                    103: FilingSubset Implementor's Guide, \s8XNSG\s0 098609 (September 1986)
                    104: .SH NOTES
                    105: Some FilingSubset defined implied attributes are not currently supported.
                    106: These include 
                    107: .IR accessList , 
                    108: .IR defaultAccessList .
                    109: .PP
                    110: .I tAsciiText
                    111: files are currently not implemented. Files of this type are currently 
                    112: transferred as 
                    113: .I tText 
                    114: files with the translation specified above used to insure compatibility with
                    115: existing Filing implementations.
                    116: .SH BUGS
                    117: Like all other server implementations in the Unix/XNS environment
                    118: a single Filing session is not allowed to exist over multiple transport (SPP)
                    119: connection.
                    120: .SH AUTHOR
                    121: Ed Flint
                    122: 

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