![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to Filing6d.n CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / new / xns / man|
Return to Filing6d.n CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / new / xns / man |
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.