Changeset View
Changeset View
Standalone View
Standalone View
bin/ls/ls.1
Show All 26 Lines | |||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" @(#)ls.1 8.7 (Berkeley) 7/29/94 | .\" @(#)ls.1 8.7 (Berkeley) 7/29/94 | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd August 18, 2018 | .Dd May 10, 2020 | ||||
.Dt LS 1 | .Dt LS 1 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm ls | .Nm ls | ||||
.Nd list directory contents | .Nd list directory contents | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm | .Nm | ||||
.Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1, | .Op Fl ABCFGHILPRSTUWZabcdfghiklmnopqrstuwxy1@, | ||||
.Op Fl -color Ns = Ns Ar when | .Op Fl -color Ns = Ns Ar when | ||||
.Op Fl D Ar format | .Op Fl D Ar format | ||||
.Op Ar | .Op Ar | ||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
For each operand that names a | For each operand that names a | ||||
.Ar file | .Ar file | ||||
of a type other than | of a type other than | ||||
directory, | directory, | ||||
▲ Show 20 Lines • Show All 375 Lines • ▼ Show 20 Lines | |||||
option is set, print file sizes grouped and separated by thousands using the | option is set, print file sizes grouped and separated by thousands using the | ||||
non-monetary separator returned by | non-monetary separator returned by | ||||
.Xr localeconv 3 , | .Xr localeconv 3 , | ||||
typically a comma or period. | typically a comma or period. | ||||
If no locale is set, or the locale does not have a non-monetary separator, this | If no locale is set, or the locale does not have a non-monetary separator, this | ||||
option has no effect. | option has no effect. | ||||
This option is not defined in | This option is not defined in | ||||
.St -p1003.1-2001 . | .St -p1003.1-2001 . | ||||
.It Fl @ | |||||
In conjunction with | |||||
.Fl l , | |||||
list any extended attributes associated with the file. | |||||
This option is not defined in | |||||
.St -p1003.1-2001 . | |||||
jilles: This sentence should be removed and instead the option should be included in the list of… | |||||
sefAuthorUnsubmitted Done Inline ActionsThe -o option is not. sef: The -o option is not. | |||||
sefAuthorUnsubmitted Done Inline ActionsI meant, the -o option doesn't have that sentence removed. I'm adding the -@ option to the STANDARDS section, but since that's the only change so far, and we're still discussing the other issues, I haven't uploaded the new diff. Sorry and thanks! sef: I meant, the -o option doesn't have that sentence removed. I'm adding the -@ option to the… | |||||
jillesUnsubmitted Not Done Inline ActionsHmm, the -o option is slightly different in that POSIX defines it with a different meaning but only under the XSI option. jilles: Hmm, the -o option is slightly different in that POSIX defines it with a different meaning but… | |||||
.El | .El | ||||
.Pp | .Pp | ||||
The | The | ||||
.Fl 1 , C , x , | .Fl 1 , C , x , | ||||
and | and | ||||
.Fl l | .Fl l | ||||
options all override each other; the last one specified determines | options all override each other; the last one specified determines | ||||
the format used. | the format used. | ||||
▲ Show 20 Lines • Show All 182 Lines • ▼ Show 20 Lines | |||||
or | or | ||||
.Xr sticky 7 . ) | .Xr sticky 7 . ) | ||||
.El | .El | ||||
.El | .El | ||||
.Pp | .Pp | ||||
The next field contains a | The next field contains a | ||||
plus | plus | ||||
.Pq Ql + | .Pq Ql + | ||||
character if the file has an ACL, or a | character if the file has an ACL, or an | ||||
space | at | ||||
.Pq Ql " " | .Pq Ql @ | ||||
if it does not. | character if the file has extended attributes, | ||||
or a space if it has neither. | |||||
If the file has both an ACL and an extended | |||||
attribute, it will show only the at character. | |||||
In conjunction with the | |||||
.Fl l | |||||
option, it will list extended attributes in | |||||
the format namespace, extended attribute name, | |||||
extended attribute size. | |||||
The | The | ||||
.Nm | .Nm | ||||
utility does not show the actual ACL; | utility does not show the actual ACL; | ||||
use | use | ||||
.Xr getfacl 1 | .Xr getfacl 1 | ||||
to do this. | to do this. | ||||
.Sh ENVIRONMENT | .Sh ENVIRONMENT | ||||
The following environment variables affect the execution of | The following environment variables affect the execution of | ||||
▲ Show 20 Lines • Show All 281 Lines • Show Last 20 Lines |
This sentence should be removed and instead the option should be included in the list of extension options in the STANDARDS section below.