Whamcloud - gitweb
LU-2446 build: Update Whamcloud copyright messages for Intel
[fs/lustre-release.git] / lustre / doc / lustre.7
1 .\" -*- nroff -*-
2 .\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
3 .\" This file may be copied under the terms of the GNU Public License.
4 .\"
5 .\" Copyright (c) 2012, Intel Corporation.
6 .\"
7 .TH Lustre 7 "2006 Jun 15" Lustre "A high-performance cluster file system"
8 .SH NAME
9 Lustre
10 .SH SYNOPSIS
11 A high-performance file system designed for clusters.
12 .SH DESCRIPTION
13 .B LustreĀ®
14 is a high-performance, massively-scalable, POSIX-compliant network file system
15 designed for the world's largest high-performance compute clusters.
16
17 Lustre filesystems are made up of multiple services typically distributed
18 across multiple nodes.  Lustre clients can contact these server nodes over
19 multiple high-speed network fabrics via LNET, the Lustre NETworking
20 system.  Clients then present the filesystem at a mount point to userspace.
21
22 A filesystem is comprised of a 
23 .I MDT
24 , MetaData Target, which stores directory and file meta-information such as
25 file ownership, timestamps, access permissions, etc, and a
26 series of 
27 .I OSTs
28 , Object Storage Targets, which hold the file data in one or more objects.
29 There is typically not a 1:1 mapping of OST objects and what is presented
30 as a file on a Lustre client.
31
32 Lustre and LNET are implemented as a series of kernel modules, for both
33 servers and clients.  LNET networks are defined in the modprobe.conf file on
34 all nodes.  Lustre is started on the clients and servers using the
35 .BR mount (8)
36 command.
37
38 .SH COMMANDS
39 .TP
40 .BR mkfs.lustre (8)
41 Format a physical disk for use as a Lustre server's backend storage (aka
42 target).
43 .TP
44 .BR tunefs.lustre (8)
45 Modify configuration information on a Lustre target disk.
46 .TP
47 .BR mount.lustre (8)
48 A helper program for
49 .BR mount (8)
50 that starts Lustre servers and clients mounts the client filesystem.
51 .TP
52 .BR lctl (8)
53 A low-level interface to control various aspects of Lustre
54 .TP
55 .BR lfs (1)
56 A user-level interface to control Lustre-specific information for
57 individual files. 
58 .B lustre_config.sh
59 Format multiple Lustre targets simultaneously from definitions in a CSV
60 file.
61 .SH BUGS
62 Please report all bugs http://bugs.whamcloud.com/
63 .SH AVAILABILITY
64 .B The
65 .BR Lustre (7) 
66 filesystem package is available via
67 .br
68 http://downloads.whamcloud.com/
69 .SH SEE ALSO
70 .BR mkfs.lustre (8),
71 .BR tunefs.lustre (8),
72 .BR mount.lustre (8),
73 .BR lctl (8),
74 .BR lfs (1),
75 .BR lfs_migrate (1),
76 .BR liblustreapi (7),
77 .BR l_getgroups (8),
78 .BR llstat (8),
79 .BR ll_recover_lost_found_objs (8),
80 .BR llverdev (8),
81 .BR lst (8),
82 .BR llobdstat (8),
83 .BR ll_decode_filter_fid (8),
84 .BR llog_reader (8),
85 .BR lshowmount (8),
86 .BR lustre_rsync (8)