lustre/doc/llapi_layout_comp_extent_get.3

   1 .TH llapi_layout_comp_extent_get 3 "2017 Apr 7" "Lustre User API"
   2 .SH NAME
   3 llapi_layout_comp_extent_get, llapi_layout_comp_extent_set \- get or set the
   4 extent of a layout component.
   5 .SH SYNOPSIS
   6 .nf
   7 .B #include <lustre/lustreapi.h>
   8 .PP
   9 .BI "int llapi_layout_comp_extent_get(const struct llapi_layout *" layout ",
  10 .BI "                                 uint64_t *" start ", uint64_t *" end );
  11 .PP
  12 .BI "int llapi_layout_comp_extent_set(const struct llapi_layout *" layout ",
  13 .BI "                                 uint64_t " start ", uint64_t "end );
  14 .fi
  15 .SH DESCRIPTION
  16 .PP
  17 The extent [start, end) defines the range of a layout component.
  18 .PP
  19 .BR llapi_layout_comp_extent_get (3)
  20 gets the extent of the current component of
  21 .I layout
  22 and stores it into
  23 .I start
  24 and
  25 .IR end .
  26 .PP
  27 .BR llapi_layout_comp_extent_set (3)
  28 sets the extent [\fIstart\fR, \fIend\fR) to the current component of
  29 .IR layout .
  30 .PP
  31 .SH RETURN VALUES
  32 .B llapi_layout_comp_extent_get()
  33 and
  34 .B llapi_layout_comp_extent_set()
  35 return 0 on success, or -1 if an error occurred (in which case, errno is
  36 set appropriately).
  37 .SH ERRORS
  38 .TP 15
  39 .SM EINVAL
  40 An invalid argument was specified.
  41 .SH "SEE ALSO"
  42 .BR llapi_layout_alloc (3),
  43 .BR llapi_layout_file_open (3),
  44 .BR llapi_layout (7),
  45 .BR lustreapi (7)