|
|
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.