Print this page
NEX-16805 Add smbutil discon command
Reviewed by: Matt Barden <matt.barden@nexenta.com>
Reviewed by: Evan Layton <evan.layton@nexenta.com>
   1 '\" te
   2 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Right Reserved.

   3 .\" Portions Copyright 1994-2008 The FreeBSD Project. All rights reserved.
   4 .\" Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following
   5 .\" disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE FREEBSD PROJECT ``AS IS'' AND
   6 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FREEBSD PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
   7 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   8 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
   9 .TH SMBUTIL 1 "Jun 24, 2009"
  10 .SH NAME
  11 smbutil \- Solaris CIFS client utility
  12 .SH SYNOPSIS
  13 .LP
  14 .nf
  15 \fB/usr/bin/smbutil crypt\fR
  16 .fi
  17 
  18 .LP
  19 .nf





  20 \fB/usr/bin/smbutil login [-c] [[\fIdomain\fR/]\fIuser\fR]\fR
  21 .fi
  22 
  23 .LP
  24 .nf
  25 \fB/usr/bin/smbutil login [-c] [\fIuser\fR[@\fIdomain\fR]]\fR
  26 .fi
  27 
  28 .LP
  29 .nf
  30 \fB/usr/bin/smbutil logout [[\fIdomain\fR/]\fIuser\fR]\fR
  31 .fi
  32 
  33 .LP
  34 .nf
  35 \fB/usr/bin/smbutil logout [\fIuser\fR[@\fIdomain\fR]]\fR
  36 .fi
  37 
  38 .LP
  39 .nf


  77 .sp
  78 .ne 2
  79 .na
  80 \fB\fBcrypt\fR\fR
  81 .ad
  82 .sp .6
  83 .RS 4n
  84 Creates a hash of a password. This subcommand prompts for a password and writes
  85 the hash to standard output. This hash value is suitable for use as a value for
  86 the \fBpassword\fR property in the \fB$HOME/.nsmbrc\fR file.
  87 .sp
  88 The hashed password begins with two dollar signs (\fB$$\fR). If you assign this
  89 hashed password to the \fBpassword\fR property in your \fB$HOME/.nsmbrc\fR, be
  90 sure that you escape the special characters in the password.
  91 .sp
  92 If you plan to store hashed passwords in your \fB$HOME/.nsmbrc\fR file, ensure
  93 that the file permissions are set so that only the owner can read or write the
  94 file (\fB400\fR or \fB600\fR), or the passwords are ignored.
  95 .RE
  96 













  97 .sp
  98 .ne 2
  99 .na
 100 \fB\fBlogin [-c] [ [[\fIdomain\fR/]\fIuser\fR] | [\fIuser\fR[@\fIdomain\fR]
 101 ]\fR\fR
 102 .ad
 103 .sp .6
 104 .RS 4n
 105 Specifies persistent password information to be used for a CIFS server user
 106 account. When you specify this information, mounts can be done without a
 107 password prompt in non-Kerberos configurations. Kerberos sites should use
 108 Kerberos automatically, not prompt for a password. If a default domain is
 109 available in SMF or \fBnsmbrc\fR(4), the domain can be omitted. If a user name
 110 is not specified, the Solaris user account name is used.
 111 .sp
 112 Use the \fB-c\fR to check whether a persistent password is set for the
 113 specified user.
 114 .sp
 115 Passwords can also be stored for a specific server by using a server name in
 116 place of the domain name. This capability is useful with servers that are


   1 '\" te
   2 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Right Reserved.
   3 .\" Copyright 2018 Nexenta Systems, Inc.  All rights reserved.
   4 .\" Portions Copyright 1994-2008 The FreeBSD Project. All rights reserved.
   5 .\" Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following
   6 .\" disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. THIS SOFTWARE IS PROVIDED BY THE FREEBSD PROJECT ``AS IS'' AND
   7 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FREEBSD PROJECT OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
   8 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
   9 .\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  10 .TH SMBUTIL 1 "Apr 11, 2018"
  11 .SH NAME
  12 smbutil \- Solaris CIFS client utility
  13 .SH SYNOPSIS
  14 .LP
  15 .nf
  16 \fB/usr/bin/smbutil crypt\fR
  17 .fi
  18 
  19 .LP
  20 .nf
  21 \fB/usr/bin/smbutil discon //[\fIdomain\fR;][\fIuser\fR@]\fIserver\fR\fR
  22 .fi
  23 
  24 .LP
  25 .nf
  26 \fB/usr/bin/smbutil login [-c] [[\fIdomain\fR/]\fIuser\fR]\fR
  27 .fi
  28 
  29 .LP
  30 .nf
  31 \fB/usr/bin/smbutil login [-c] [\fIuser\fR[@\fIdomain\fR]]\fR
  32 .fi
  33 
  34 .LP
  35 .nf
  36 \fB/usr/bin/smbutil logout [[\fIdomain\fR/]\fIuser\fR]\fR
  37 .fi
  38 
  39 .LP
  40 .nf
  41 \fB/usr/bin/smbutil logout [\fIuser\fR[@\fIdomain\fR]]\fR
  42 .fi
  43 
  44 .LP
  45 .nf


  83 .sp
  84 .ne 2
  85 .na
  86 \fB\fBcrypt\fR\fR
  87 .ad
  88 .sp .6
  89 .RS 4n
  90 Creates a hash of a password. This subcommand prompts for a password and writes
  91 the hash to standard output. This hash value is suitable for use as a value for
  92 the \fBpassword\fR property in the \fB$HOME/.nsmbrc\fR file.
  93 .sp
  94 The hashed password begins with two dollar signs (\fB$$\fR). If you assign this
  95 hashed password to the \fBpassword\fR property in your \fB$HOME/.nsmbrc\fR, be
  96 sure that you escape the special characters in the password.
  97 .sp
  98 If you plan to store hashed passwords in your \fB$HOME/.nsmbrc\fR file, ensure
  99 that the file permissions are set so that only the owner can read or write the
 100 file (\fB400\fR or \fB600\fR), or the passwords are ignored.
 101 .RE
 102 
 103 .sp
 104 .ne 2
 105 .na
 106 \fB\fBdiscon -U \fIuser\fR]
 107 //[\fIdomain\fR;][\fIuser\fR\fIserver\fR\fR\fR
 108 .ad
 109 .sp .6
 110 .RS 4n
 111 Disconnects the specified SMB session to \fIserver\fR.
 112 Usage is similar to the \fB\fBview\fR\fR sub-command.
 113 This sub-command is primarily for use in tests.
 114 .RE
 115 
 116 .sp
 117 .ne 2
 118 .na
 119 \fB\fBlogin [-c] [ [[\fIdomain\fR/]\fIuser\fR] | [\fIuser\fR[@\fIdomain\fR]
 120 ]\fR\fR
 121 .ad
 122 .sp .6
 123 .RS 4n
 124 Specifies persistent password information to be used for a CIFS server user
 125 account. When you specify this information, mounts can be done without a
 126 password prompt in non-Kerberos configurations. Kerberos sites should use
 127 Kerberos automatically, not prompt for a password. If a default domain is
 128 available in SMF or \fBnsmbrc\fR(4), the domain can be omitted. If a user name
 129 is not specified, the Solaris user account name is used.
 130 .sp
 131 Use the \fB-c\fR to check whether a persistent password is set for the
 132 specified user.
 133 .sp
 134 Passwords can also be stored for a specific server by using a server name in
 135 place of the domain name. This capability is useful with servers that are