.Dd June 3, 2004
.Dt MDLS 1
.Os Mac\ OS X
.Sh NAME
.Nm mdls
.Nd lists the metadata attributes for the specified file 
.Sh SYNOPSIS
.Nm
.Op Fl name Ar attributeName
.Op Fl raw Op Fl nullMarker Ar markerString
.Ar
.Sh DESCRIPTION
The
.Nm
command prints the values of all the metadata attributes associated with the files provided as an argument.
.Pp
The following options are available:
.Bl -tag -width -nullMarker
.It Fl name
Print only the matching metadata attribute value.  Can be used multiple times.
.It Fl raw
Print raw attribute data in the order that was requested.
Fields will be separated with a
.Tn ASCII NUL
character, suitable for piping to
.Xr xargs 1
.Fl 0 .
.It Fl nullMarker
Sets a marker string to be used when a requested attribute is null.
Only used in -raw mode.
Default is "(null)".
.El
.Sh SEE ALSO
.Xr mdfind 1 ,
.Xr mdutil 1
.Xr xargs 1