.\"
.\" Modified Sat Dec 22 22:25:33 2001 by Martin Schulze <joey@infodrom.org>
.\"
-.TH DIR_COLORS 5 2001-12-26 "GNU" "Linux User Manual"
+.TH DIR_COLORS 5 2013-08-09 "GNU" "Linux User Manual"
.SH NAME
dir_colors \- configuration file for dircolors(1)
.SH DESCRIPTION
.TP
.B NORMAL \fIcolor-sequence\fR
Specifies the color used for normal (nonfilename) text.
+
+Synonym:
+.BR NORM .
.TP
.B FILE \fIcolor-sequence\fR
Specifies the color used for a regular file.
.TP
.B LINK \fIcolor-sequence\fR
Specifies the color used for a symbolic link.
+
+Synonyms:
+.BR LNK ,
+.BR SYMLINK .
.TP
.B ORPHAN \fIcolor-sequence\fR
Specifies the color used for an orphaned symbolic link (one which
.TP
.B FIFO \fIcolor-sequence\fR
Specifies the color used for a FIFO (named pipe).
+
+Synonym:
+.BR PIPE .
.TP
.B SOCK \fIcolor-sequence\fR
Specifies the color used for a socket.
.TP
.B BLK \fIcolor-sequence\fR
Specifies the color used for a block device special file.
+
+Synonym:
+.BR BLOCK .
.TP
.B CHR \fIcolor-sequence\fR
Specifies the color used for a character device special file.
+
+Synonym:
+.BR CHAR .
.TP
.B EXEC \fIcolor-sequence\fR
Specifies the color used for a file with the executable attribute set.
.TP
+.B SUID \fIcolor-sequence\fR
+Specifies the color used for a file with the set-user-ID attribute set.
+
+Synonym:
+.BR SETUID .
+.TP
+.B SGID \fIcolor-sequence\fR
+Specifies the color used for a file with the set-group-ID attribute set.
+
+Synonym:
+.BR SETGID .
+.TP
+.B STICKY \fIcolor-sequence\fR
+Specifies the color used for a directory with the sticky attribute set.
+.TP
+.B STICKY_OTHER_WRITABLE \fIcolor-sequence\fR
+Specifies the color used for a other-writable directory with the executable attribute set.
+
+Synonym:
+.BR OWT .
+.TP
+.B OTHER_WRITABLE \fIcolor-sequence\fR
+Specifies the color used for a other-writable directory without the executable attribute set.
+
+Synonym:
+.BR OWR .
+.TP
.B LEFTCODE \fIcolor-sequence\fR
Specifies the
.I "left code"
for non-ISO\ 6429 terminals (see below).
+
+Synonym:
+.BR LEFT .
.TP
.B RIGHTCODE \fIcolor-sequence\fR
Specifies the
.I "right code"
for non-ISO\ 6429 terminals (see below).
+
+Synonym:
+.BR RIGHT .
.TP
.B ENDCODE \fIcolor-sequence\fR
Specifies the
.I "end code"
for non-ISO\ 6429 terminals (see below).
+
+Synonym:
+.BR END .
.TP
\fB*\fIextension\fR \fIcolor-sequence\fR
Specifies the color used for any file that ends in \fIextension\fR.
separated by semicolons.
The most common codes are:
.sp
-.RS +.2i
-.ta 1.0i
-.nf
- 0 to restore default color
- 1 for brighter colors
- 4 for underlined text
- 5 for flashing text
-30 for black foreground
-31 for red foreground
-32 for green foreground
-33 for yellow (or brown) foreground
-34 for blue foreground
-35 for purple foreground
-36 for cyan foreground
-37 for white (or gray) foreground
-40 for black background
-41 for red background
-42 for green background
-43 for yellow (or brown) background
-44 for blue background
-45 for purple background
-46 for cyan background
-47 for white (or gray) background
-.fi
+.RS
+.TS
+l l.
+ 0 to restore default color
+ 1 for brighter colors
+ 4 for underlined text
+ 5 for flashing text
+30 for black foreground
+31 for red foreground
+32 for green foreground
+33 for yellow (or brown) foreground
+34 for blue foreground
+35 for purple foreground
+36 for cyan foreground
+37 for white (or gray) foreground
+40 for black background
+41 for red background
+42 for green background
+43 for yellow (or brown) background
+44 for blue background
+45 for purple background
+46 for cyan background
+47 for white (or gray) background
+.TE
.RE
.sp
Not all commands will work on all systems or display devices.
.B ls
uses the following defaults:
.sp
-.RS +.2i
-.ta 1.0i 2.5i
-.nf
-\fBNORMAL\fR 0 Normal (nonfilename) text
-\fBFILE\fR 0 Regular file
-\fBDIR\fR 32 Directory
-\fBLINK\fR 36 Symbolic link
-\fBORPHAN\fR undefined Orphaned symbolic link
-\fBMISSING\fR undefined Missing file
-\fBFIFO\fR 31 Named pipe (FIFO)
-\fBSOCK\fR 33 Socket
-\fBBLK\fR 44;37 Block device
-\fBCHR\fR 44;37 Character device
-\fBEXEC\fR 35 Executable file
-.fi
-.RE
+.TS
+lb l l.
+NORMAL 0 Normal (nonfilename) text
+FILE 0 Regular file
+DIR 32 Directory
+LINK 36 Symbolic link
+ORPHAN undefined Orphaned symbolic link
+MISSING undefined Missing file
+FIFO 31 Named pipe (FIFO)
+SOCK 33 Socket
+BLK 44;37 Block device
+CHR 44;37 Character device
+EXEC 35 Executable file
+.TE
.sp
A few terminal programs do not recognize the default
properly.
The C-style notation
includes the following characters:
.sp
-.RS +.2i
-.ta 1.0i
-.nf
-\fB\ea\fR Bell (ASCII 7)
-\fB\eb\fR Backspace (ASCII 8)
-\fB\ee\fR Escape (ASCII 27)
-\fB\ef\fR Form feed (ASCII 12)
-\fB\en\fR Newline (ASCII 10)
-\fB\er\fR Carriage Return (ASCII 13)
-\fB\et\fR Tab (ASCII 9)
-\fB\ev\fR Vertical Tab (ASCII 11)
-\fB\e?\fR Delete (ASCII 127)
-\fB\e\fInnn\fR Any character (octal notation)
-\fB\ex\fInnn\fR Any character (hexadecimal notation)
-\fB\e_\fR Space
-\fB\e\e\fR Backslash (\e)
-\fB\e^\fR Caret (^)
-\fB\e#\fR Hash mark (#)
-.fi
+.RS
+.TS
+lb l.
+\ea Bell (ASCII 7)
+\eb Backspace (ASCII 8)
+\ee Escape (ASCII 27)
+\ef Form feed (ASCII 12)
+\en Newline (ASCII 10)
+\er Carriage Return (ASCII 13)
+\et Tab (ASCII 9)
+\ev Vertical Tab (ASCII 11)
+\e? Delete (ASCII 127)
+\e\fInnn Any character (octal notation)
+\ex\fInnn Any character (hexadecimal notation)
+\e_ Space
+\e\e Backslash (\e)
+\e^ Caret (^)
+\e# Hash mark (#)
+.TE
.RE
.sp
-Please note that escapes are necessary to enter a space, backslash,
+Note that escapes are necessary to enter a space, backslash,
caret, or any control character anywhere in the string, as well as a
hash mark as the first character.
.SH FILES
.B RIGHTCODE
definitions, which are used by ISO 6429 terminals are:
.sp
-.RS +.2i
-.ta 1.0i
-.nf
-\fBLEFTCODE\fR \ee[
-\fBRIGHTCODE\fR m
-.fi
+.RS
+.TS
+lb l.
+LEFTCODE \ee[
+RIGHTCODE m
+.TE
.RE
.sp
The default
.BR ls (1),
.BR stty (1),
.BR xterm (1)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.