usr.bin/ncplogin/ncplogin.1

   1 .\" $FreeBSD$
   2 .Dd Sep 15, 1999
   3 .Dt NCPLOGIN 1
   4 .Os
   5 .Sh NAME
   6 .Nm ncplogin
   7 .Nd create permanent connection to a NetWare server
   8 .Sh SYNOPSIS
   9 .Nm ncplogin
  10 .Op Fl BCDN
  11 .Op Fl S Ar server
  12 .Op Fl U Ar user
  13 .Op Fl A Ar host
  14 .Op Fl I Ar level
  15 .Op Fl M Ar mode
  16 .Oo
  17 .Fl O Xo
  18 .Op Ar owner Ns
  19 .Op : Ns Ar group
  20 .Xc
  21 .Oc
  22 .Op Fl R Ar retrycount
  23 .Op Fl T Ar tree
  24 .Op Fl W Ar timeout
  25 .Nm ncplogin
  26 .Op Fl BCDN
  27 .Op Fl A Ar host
  28 .Op Fl I Ar level
  29 .Op Fl M Ar mode
  30 .Oo
  31 .Fl O Xo
  32 .Op Ar owner Ns
  33 .Op : Ns Ar group
  34 .Xc
  35 .Oc
  36 .Op Fl R Ar retrycount
  37 .Op Fl T Ar tree
  38 .Op Fl W Ar timeout
  39 .No / Ns Ar server Ns : Ns Ar user
  40 .Sh DESCRIPTION
  41 Connections to a
  42 .Tn NetWare
  43 server can be created and used independently of the
  44 .Xr mount_nwfs 8
  45 command.
  46 Connections can be created by any user.
  47 Each user can have multiple
  48 connections, but each NetWareServer:NetWareUser pair should be unique.
  49 .Pp
  50 The
  51 .Nm
  52 command is used to create a permanent connection to a
  53 .Tn NetWare
  54 server.
  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
  59 .Xr ncplogout 1
  60 command.
  61 .Pp
  62 Upper case options described in this manual
  63 are common for other ncp* programs and are referred to as
  64 .Qq connection options .
  65 Options
  66 .Fl U
  67 and
  68 .Fl S
  69 are mutually exclusive with the
  70 .No / Ns Ar server Ns : Ns Ar user
  71 syntax.
  72 .Pp
  73 The options are:
  74 .Bl -tag -width indent
  75 .It Fl S Ar server
  76 Specify the name of the
  77 .Tn NetWare server to connect to.
  78 This affect only
  79 .Tn IPX
  80 servers.
  81 For native
  82 .Tn IP
  83 servers, see the
  84 .Fl A
  85 option.
  86 .It Fl U Ar user
  87 Specify the name of the user used in the login sequence.
  88 .It Fl A Ar host
  89 Use the
  90 .Tn UDP
  91 protocol to connect to a
  92 .Tn NetWare
  93 5.x server specified by the
  94 .Ar host
  95 argument.
  96 .It Fl C
  97 Do not convert the password to uppercase.
  98 .It Fl D
  99 Mark the connection as primary.
 100 The option can be used to modify existing connections.
 101 Only the
 102 .Nm
 103 program accepts this option.
 104 .It Fl I Ar signature_level
 105 Try to use
 106 .Ar signature_level .
 107 Available values are:
 108 .Bd -literal -offset indent
 109 Value   Meaning
 110 0       disable signatures
 111 1       enable (use if required by server)
 112 2       request but do not require signing
 113 3       require signatures
 114 .Ed
 115 .Pp
 116 Note that only packet header signing is implemented.
 117 .It Fl M Ar mode
 118 Share this connection.
 119 The bits in the
 120 .Ar mode
 121 argument are similar to standard file permissions:
 122 .Bd -literal -offset indent
 123 Mask    Meaning
 124 4       READ    - connection will be visible.
 125 2       WRITE   - connection can be closed/modified
 126 1       EXECUTE - user allowed to execute requests.
 127 .Ed
 128 .Pp
 129 By default, the connection is created with
 130 .Ar mode
 131 0700
 132 and only the owner can use it.
 133 Specifying 0750 as the argument to the
 134 .Fl M
 135 option would allow read-only group access as well.
 136 This would allow the group to perform
 137 .Tn NCP
 138 requests,
 139 but not to destroy the connection.
 140 When a server is not explicitly specified,
 141 ncp* programs try to find a suitable connection in the following order:
 142 .Bl -enum -offset indent
 143 .It
 144 Try to find a connection owned by the user.
 145 If there is more than one such
 146 connection, try to determine which one is primary.
 147 The primary flag is set with the
 148 .Fl D
 149 option.
 150 .It
 151 If the primary connection could not be determined,
 152 the first shared connection will be used.
 153 .El
 154 .It Fl N
 155 Do not prompt for a password.
 156 At run time,
 157 .Nm
 158 reads the
 159 .Pa ~/.nwfsrc
 160 file for additional configuration parameters and a password.
 161 If no password is found for the specified
 162 .Ar server Ns : Ns Ar user
 163 pair,
 164 .Nm
 165 prompts for it.
 166 .It Fl O
 167 Specify the
 168 .Ar owner
 169 and
 170 .Ar group
 171 attributes for the connection.
 172 Newly created connections take the
 173 .Ar owner
 174 attribute from the creating user's username and the
 175 .Ar group
 176 attribute from the creating user's primary group.
 177 This option overrides that behaviour.
 178 Only the superuser can override the
 179 .Ar owner
 180 attribute for a connection.
 181 .It Fl P
 182 Mark the connection as permanent.
 183 .Nm
 184 always creates permanent connections.
 185 This option can be used in other ncp*
 186 programs.
 187 .It Fl R Ar retry_count
 188 Specify the number of retries to be performed
 189 before dropping the connection.
 190 The default value is 10.
 191 .Pp
 192 Note: after a connection is marked
 193 .Sq BAD ,
 194 each request will try to restore it.
 195 This process restores only the
 196 .Tn NCP
 197 connection;
 198 it does not reopen any files that were open
 199 at the time that the connection was marked
 200 .Sq BAD .
 201 .It Fl W Ar timeout
 202 Specify the server request timeout in seconds.
 203 The default is 5 seconds.
 204 .It / Ns Ar server Ns : Ns Ar user
 205 This syntax is provided for the sake of simplicity
 206 and is mutually exclusive with the
 207 .Fl S
 208 and
 209 .Fl U
 210 options.
 211 .El
 212 .Sh IMPLEMENTATION NOTES
 213 Low level connection management is implemented in the
 214 .Pa ncp.ko
 215 module.
 216 The
 217 .Xr IPXrouted 8
 218 program is also required for
 219 .Tn IPX
 220 support.
 221 .Sh FILES
 222 .Bl -tag -width /var/log/wtmp -compact
 223 .It Pa ~/.nwfsrc
 224 keeps static parameters for connections and other information
 225 See
 226 .Pa /usr/share/examples/nwclient/dot.nwfsrc
 227 for details.
 228 .Sh HISTORY
 229 The
 230 .Nm
 231 command first appeared in
 232 .Fx 4.0 .
 233 .Sh AUTHORS
 234 .An Boris Popov Aq bp@butya.kz ,
 235 .Aq rbp@chat.ru
 236 .Sh BUGS
 237 Please report any bugs to the author.