pscol(1)

Usage

eval `pscol [file] [{-s<p | t>}] [-C] [-f file] [-V] `

pscol -c [u+cm [{p | t}]] [-f file] [-V]

pscol [-h] [-v]

Overview

pscol sets environment variables to control the colorization of ps(1) and top(1). pscol cannot directly set variables in you environement, so it outputs environement variable settings to stdout, and you must instruct your shell to use them.

Options

file If specified, must be the first parameter listed

-c[u+cm[p|t]]

takes the current PS_COLORS and/or TOP_COLORS and creates $HOME/.pscolor. Use -f to override this file

Creation features:

c: turn off converting ANSI codes to readable format

m: turn off converting the mark-up type to readable format

u: turn off converting UID to user names

+: turn off converting current UID to +

Other:

p: writes out only the PS_COLORS variable

t: writes out only the TOP_COLORS variable

-f file: Use a different file instead of /etc/pscolors or $HOME/.pscolor

-h: Displays a help screen and exits

-o<p|t>: prints the PS or TOP color string to stdout.
this would be used to set a variable.
p returns the PS color string
t returns the TOP color string
Ie: ps=`pscol -op`

-s[p|t]: used to set the PS or TOP color variable.
p set PS_COLORS only
t set TOP_COLORS only

-v: Prints the version info and exits

-C: use CSH style setenv instead of using bourne style export

-V: Verbose mode. Reports what goes on to stderr.

Files

/etc/pscolor: System wide colorization file. See pscolor(5) for more information

$HOME/.pscolor: Per user colorization file. See pscolor(5) for more information

Environment

PS_COLORS: ps(1) color string

TOP_COLORS: top(1) color string

HOME: user's home directory where the per user colorization file is stored

Distribution

Redistribution is subject to the GNU public license.

ps(1) report a snapshot of the current processes. ps_color(7) color support for ps and top The showtask module, which is used by ps and top has support for colorization of tasks. The color markup is controlled by markup hints in $PS_COLORS resp. $TOP_COLORS. There is a program called pscol, (similar to dircolors) in a separate package that can be used to set these environment variables. The environment variables should contain a list of entries of the form markup_type,markup_value,markup_string separated by %, where markup_type is the id of the markup_type from the following table, markup value is a value of the type corresponding to the markup_type and markup_string is an ANSI markupstring consisting of a forground color, a background color or an attribute all separated by a semicolon. Note that next to no check is made whether an output device supports ANSI colors The order of the markup entries is important, as the first recognized will be used. Currently the following markup_types are recognised by showtask: Attributes can only be defined for a color_pair, i.e. it is impossible to have a attribute operate on background color only. These are the ANSI names for the attributes. Not always do the names correspond to the actual realisation, e.g. bold usually means bold and bright. Some attributes may have no effect at all. This is allowed by ANSI. pscolor(5) color definitions for ps(1) and top(1) top(1) display Linux processes

Referred to by

pscolor(5) color definitions for ps(1) and top(1)