xref: /freebsd/contrib/smbfs/smbutil/smbutil.1 (revision f1b9d12761de3c33754f03e6d2a5bf9f1b40aad9)
1.\" $Id: smbutil.1,v 1.3 2000/07/17 01:49:27 bp Exp $
2.Dd Feb 14, 2000
3.Dt SMBUTIL 1
4.Os
5.Sh NAME
6.Nm smbutil
7.Nd Interface to SMB requester
8.Sh SYNOPSIS
9.Nm smbutil
10.Op Fl hv
11.Ar command
12.Op Fl options
13.Op Ar args
14.Sh DESCRIPTION
15The
16.Nm
17command used to control SMB requester and issue various commands.
18.Pp
19There are two types of options - global and local to specified command.
20.Pp
21The global options are:
22.Bl -tag -width indent
23.It Fl h
24Print short help message.
25.It Fl v
26Verbose output.
27.El
28.Pp
29The commands and local options are:
30.Bl -tag -width indent
31.It Em crypt Op password
32Slightly encrypt clear text password to use it in the
33.Pa ~/.nsmbrc
34file. The encrypted password starts with '$$1' symbols.
35Warning: the encryption function is very weak and intented only to hide
36clear text password.
37If
38.Ar password
39is ommited from command line, program will prompt for one.
40.It Em help Ar command
41Print usage information about
42.Ar command .
43.It Em lc
44List active connections and their parameters.
45.It Xo
46.Em login
47.Op Fl connection\ options
48.Ar //user@server Ns Op Ar /share
49.Xc
50Login/attach to the specified
51.Ar server
52and/or
53.Ar share
54as
55.Ar user .
56This command will create and authenticate connection to an SMB server, and
57will leave it active after exit.
58Thus, one can login only once and then
59use other SMB commands without authentication procedure and additional
60connections.
61For the description of
62.Op Fl connection\ options
63see
64.Xr mount_smbfs 8
65command (all uppercase options are connection options).
66.It Xo
67.Em logout
68.Ar //user@server Ns Op Ar /share
69.Xc
70Logout/detach from the specified
71.Ar server
72and/or
73.Ar share
74as
75.Ar user .
76This command will destroy connection created by
77.Ar login
78command. A connection may not be closed immediately if it used by other
79programs.
80.It Xo
81.Em lookup
82.Op Fl w Ar host
83.Ar name
84.Xc
85Resolve given
86.Ar name
87to IP address.
88NetBIOS name server can be directly specified via
89.Op Fl w
90option.
91.It Xo
92.Em print
93.Op Fl connection\ options
94.Ar //user@server/share
95.Ar file
96.Xc
97Send given
98.Ar file
99to the specified queue on the remote server.
100If
101.Ar file
102is '-', then standard input will be used.
103.It Xo
104.Em view
105.Op Fl connection\ options
106.Ar //user@server
107.Xc
108List resources avaliable on the specified
109.Ar server
110for the user
111.Ar user .
112.El
113.Sh FILES
114.Bl -tag -width /var/log/wtmp -compact
115.It Pa ~/.nsmbrc
116keeps description for each connection.
117See
118.Pa ./examples/dot.nsmbrc
119for details.
120.Sh AUTHORS
121.An Boris Popov Aq bp@butya.kz ,
122.Aq bp@freebsd.org
123.Sh BUGS
124Please report any bugs to the author.
125