1276f398a8ff0086d81e0fea438f8b3f739573d8
[lufs.git] / man / lufsmount.1
1 .\" Process this file with
2 .\" groff -man -Tascii foo.1
3 .\"
4 .TH LUFSMOUNT "1" "January 2003" LUFS "User Commands"
5 .SH NAME
6 lufsmount \- mount an LUFS file system
7 .SH SYNOPSIS
8 .BI "lufsmount " file_system ://[ "user" [: "pass" ]@] "host" [: "port" ][/ "remote_root" "] [-cdfghoOpquv]"
9 .SH DESCRIPTION
10 The 
11 .B lufsmount
12 command is a convenience wrapper for mounting LUFS filesystems. 
13 It provides a more natural syntax and allows regular users to take 
14 advantage of it, provided that the LUFS mount/umount utilities 
15 (lufsmnt & lufsumount) have been installed suid root. Conversely, the
16 .BR lufsumount (1)
17 command will detach the mounted file system.
18 .SH OPTIONS
19 Options available for the 
20 .B lufsmount
21 command:
22 .TP
23 .BI \-c " CHAN" ", \-\-channels=" CHAN
24 Specify the number of communication channels per LUFS file system.
25 .TP
26 .BI \-d " MASK" ", \-\-dmask=" MASK
27 Octal mask to be OR-ed on directory permissions (minimum dir permissions).
28 .TP
29 .BI \-f " MASK" ", \-\-fmask=" MASK
30 Octal mask to be OR-ed on file permissions (minimum file permissions).
31 .TP
32 .BI \-g " GID" ", \-\-gid=" GID
33 Set 
34 .I GID
35 as the owning 
36 .B gid
37 on all the file system entries.
38 .TP
39 .B \-h, \-\-help
40 Display a help message.
41 .TP
42 .BI \-o " OPT=VAL[,...]" ", \-\-opts " OPT=VAL[,...]
43 File system specific options. These options will be passed unparsed to the
44 file system module.
45 .TP
46 .B \-O, \-\-own_fs
47 The mounting user will be the owner of the whole mounted file system. 
48 Permissions on the file system entries will be tweaked to reflect 
49 actual remote access rights.
50 .TP
51 .B \-p, \-\-password
52 Prompt for a password, if none specified.
53 .TP
54 .B \-q, \-\-quiet
55 Disable logging from the 
56 .B lufsd 
57 daemon. All file descriptors are closed.
58 .TP
59 .BI \-u " UID" ", \-\-uid=" UID
60 Set
61 .I UID
62 as the owning 
63 .B uid
64 on all the file system entries.
65 .TP
66 .B \-v, \-\-verbose
67 Print the mount command before executing.
68 .SH FILES
69 .I /etc/lufs.conf
70 .RS
71 The LUFS configuration file. See
72 .BR lufs (8)
73 for further details.
74 .RE
75 .I /etc/mtab
76 .RS
77 Table of mounted file systems
78 .SH BUGS
79 The
80 .B lufsmount
81 utility cannot handle LUFS filesystems which require a special/different
82 URL syntax.
83 .SH AUTHOR
84 Florin Malita <mali at go dot ro>
85 .SH "SEE ALSO"
86 .BR lufsumount (1),
87 .BR mount (8),
88 .BR umount (8)
89