LUDOC-296 protocol: remove internal details from descriptions

[doc/protocol.git] / glossary.txt

diff --git a/glossary.txt b/glossary.txt
index 35cb51d..92194fb 100644 (file)
--- a/glossary.txt
+++ b/glossary.txt
@@ -22,9 +22,9 @@ consistent (cache-coherent) view of the data objects in the file
 system.
 
 early reply::
-A message returned in response to a request message that allows the
-target to extend timeout values without otherwise indicating the
-request has progressed.
+A partial message reply returned in response to a request message
+that allows the target to indicate to the requestor to increase its
+timeout value without otherwise indicating the request has progressed.
 
 export::
 The term for the per-client shared state information held by a server.
@@ -36,14 +36,14 @@ The term for the per-target shared state information held by a client.
 
 Inodes and Extended Attributes::
 Metadata about a Lustre file is encoded in the extended attributes of
-an inode in the back-end file system on the MDS. Some of that
+an inode in the back-end file system on the MDT. Some of that
 information establishes the stripe layout of the file. The size of the
-stripe layout information varies among Lustre file systems. The amount
+stripe layout information may be different for each file. The amount
 of space reserved for layout information is a small as possible given
-the maximum stripe count possible on the file system. Clients, servers,
+the maximum stripe count on the file system. Clients, servers,
 and the distributed lock manager will all need to be aware of this
-size, which is communicated in the 'ocd_ibis_known' filed of the
-'obd_connect_data' structure.
+size, which is communicated in the 'ocd_max_easize' filed of the
+<<obd_connect_data>> structure.
 
 LNet::
 A lower level protocol employed by PtlRPC to abstract the mechanisms
@@ -68,13 +68,15 @@ Metadata Server::
 A metadata server (MDS) is a computer responsible for running the
 Lustre kernel services in support of managing the POSIX-compliant name
 space and the indices associating files in that name space with the
-locations of their corresponding objects. As of v2.4 there can be
-multiple MDSs in a Lustre file system.
+locations of their corresponding objects. As of Lustre 2.4 there can be
+multiple MDSs in a single Lustre file system.
 
 Metadata Target::
 A metadata target (MDT) is the service provided by an MDS that
 mediates the management of name space indices on the underlying file
-system hardware. As of v2.4 there can be multiple MDTs on an MDS.
+system hardware. As of Lustre 2.4 there can be multiple MDTs on an MDS.
+An MDT can be served by different MDS nodes at different times, but
+will only be available from a single MDS at any given time.
 
 Object Based Disk::
 Object Based Disk (OBD) is the term used for any target, MDT or OST.
@@ -88,7 +90,9 @@ system.
 Object Storage Target::
 An object storage target (OST) is the service provided by an OSS that
 mediates the placement of data objects on the specific underlying file
-system hardware. There can be multiple OSTs on a given OSS.
+system hardware. There can be multiple OSTs on a given OSS.  An OST
+may be served by different OSS nodes at different times, but will
+only be available from one OSS at any given time.
 
 protocol::
 An agreed upon formalism for communicating between two entities, such