of the given mode on the given byte range </para>
<para><literal>noexpand</literal> Disable extent lock expansion
behavior for I/O to this file descriptor</para>
- <para><literal>unset</literal> Unset/clear a previous advice
- (Currently only supports LU_ADVISE_LOCKNOEXPAND)</para>
</entry>
</row>
<row>
from the normal LDLM locking behavior.
</para>
<para>
- Note that the <literal>noexpand</literal> and <literal>unset</literal>
- advices work on a specific file descriptor, so using them via lfs has no
- effect. They must be used on a particular file descriptor which is used
- for i/o to have any effect.
+ Note that the <literal>noexpand</literal> advice works on a specific
+ file descriptor, so using it via lfs has no effect. It must be used
+ on a particular file descriptor which is used for i/o to have any effect.
</para>
<para>The main difference between the Linux <literal>fadvise()</literal>
system call and <literal>lfs ladvise</literal> is that
descriptor <emphasis>fd</emphasis> from an application to one or more
Lustre servers. Optionally, <emphasis>flags</emphasis> can modify how
the advice will be processed via bitwise-or'd values:</para>
- <itemizedlist><listitem>
- <para><literal>LF_ASYNC</literal>: Clients return to userspace
+ <itemizedlist>
+ <listitem>
+ <para><literal>LF_ASYNC</literal>: Clients return to userspace
immediately after submitting ladvise RPCs, leaving server threads to
handle the advices asynchronously.</para>
- </listitem></itemizedlist>
+ </listitem>
+ <listitem>
+ <para><literal>LF_UNSET</literal>: Unset/clear a previous advice
+ (Currently only supports LU_ADVISE_LOCKNOEXPAND).</para>
+ </listitem>
+ </itemizedlist>
<para>Each of the <emphasis>ladvise</emphasis> elements is an
<emphasis>llapi_lu_ladvise</emphasis> structure, which contains the
following fields:
<entry>
<para>When using advices which support them, the 'lla_value2'
field is used to communicate per-advice flags and can be
- referred to as 'lla_peradvice_flags'.</para>
+ referred to as 'lla_peradvice_flags'. Both LF_ASYNC and
+ LF_UNSET are supported as peradvice flags.</para>
</entry>
</row>
<row>