1 .\" $FreeBSD: src/usr.bin/ncplogin/ncplogin.1,v 1.4.2.8 2002/06/21 15:28:29 charnier Exp $
7 .Nd create permanent connection to a NetWare server
22 .Op Fl R Ar retrycount
36 .Op Fl R Ar retrycount
39 .No / Ns Ar server Ns : Ns Ar user
43 server can be created and used independently of the
46 Connections can be created by any user.
47 Each user can have multiple
48 connections, but each NetWareServer:NetWareUser pair should be unique.
52 command is used to create a permanent connection to a
55 Permanent connections will stay connected even if no applications use them.
56 This allows users to run different ncp* programs
57 without specifying a file server and user to use.
58 Established connections can be destroyed with the
62 Upper case options described in this manual
63 are common for other ncp* programs and are referred to as
64 .Qq connection options .
69 are mutually exclusive with the
70 .No / Ns Ar server Ns : Ns Ar user
74 .Bl -tag -width indent
76 Specify the name of the
88 Specify the name of the user used in the login sequence.
92 protocol to connect to a
94 5.x server specified by the
98 Do not convert the password to uppercase.
100 Mark the connection as primary.
101 The option can be used to modify existing connections.
104 program accepts this option.
105 .It Fl I Ar signature_level
107 .Ar signature_level .
108 Available values are:
109 .Bd -literal -offset indent
112 1 enable (use if required by server)
113 2 request but do not require signing
117 Note that only packet header signing is implemented.
119 Share this connection.
122 argument are similar to standard file permissions:
123 .Bd -literal -offset indent
125 4 READ - connection will be visible.
126 2 WRITE - connection can be closed/modified
127 1 EXECUTE - user allowed to execute requests.
130 By default, the connection is created with
133 and only the owner can use it.
134 Specifying 0750 as the argument to the
136 option would allow read-only group access as well.
137 This would allow the group to perform
140 but not to destroy the connection.
141 When a server is not explicitly specified,
142 ncp* programs try to find a suitable connection in the following order:
143 .Bl -enum -offset indent
145 Try to find a connection owned by the user.
146 If there is more than one such
147 connection, try to determine which one is primary.
148 The primary flag is set with the
152 If the primary connection could not be determined,
153 the first shared connection will be used.
156 Do not prompt for a password.
161 file for additional configuration parameters and a password.
162 If no password is found for the specified
163 .Ar server Ns : Ns Ar user
172 attributes for the connection.
173 Newly created connections take the
175 attribute from the creating user's username and the
177 attribute from the creating user's primary group.
178 This option overrides that behaviour.
179 Only the superuser can override the
181 attribute for a connection.
183 Mark the connection as permanent.
186 utility always creates permanent connections.
187 This option can be used in other ncp*
189 .It Fl R Ar retry_count
190 Specify the number of retries to be performed
191 before dropping the connection.
192 The default value is 10.
194 Note: after a connection is marked
196 each request will try to restore it.
197 This process restores only the
200 it does not reopen any files that were open
201 at the time that the connection was marked
204 Specify the server request timeout in seconds.
205 The default is 5 seconds.
206 .It / Ns Ar server Ns : Ns Ar user
207 This syntax is provided for the sake of simplicity
208 and is mutually exclusive with the
214 .Sh IMPLEMENTATION NOTES
215 Low level connection management is implemented in the
220 program is also required for
224 .Bl -tag -width /var/log/wtmp -compact
226 keeps static parameters for connections and other information
228 .Pa /usr/share/examples/nwclient/dot.nwfsrc
234 command first appeared in
237 .An Boris Popov Aq bp@butya.kz ,
240 Please report any bugs to the author.