source: postlfs/config/profile-systemd.xml@ 237d47f

krejzi/svn
Last change on this file since 237d47f was c806f4a, checked in by Krejzi <krejzi@…>, 10 years ago

Import postlfs config section.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd-ng@14735 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 19.0 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="postlfs-config-profile" xreflabel="The Bash Shell Startup Files">
9 <?dbhtml filename="profile.html"?>
10
11 <sect1info>
12 <othername>$LastChangedBy$</othername>
13 <date>$Date$</date>
14 </sect1info>
15
16 <title>The Bash Shell Startup Files</title>
17
18 <para>The shell program <filename>/bin/bash</filename> (hereafter
19 referred to as just "the shell") uses a collection of startup files to
20 help create an environment. Each file has a specific use and
21 may affect login and interactive environments differently. The files in
22 the <filename class="directory">/etc</filename> directory generally provide
23 global settings. If an equivalent file exists in your home directory it may
24 override the global settings.</para>
25
26 <para>An interactive login shell is started after a successful login, using
27 <filename>/bin/login</filename>, by reading the <filename>/etc/passwd</filename>
28 file. This shell invocation normally reads <filename>/etc/profile</filename>
29 and its private equivalent <filename>~/.bash_profile</filename> upon
30 startup.</para>
31
32 <para>An interactive non-login shell is normally started at the command-line
33 using a shell program (e.g.,
34 <prompt>[prompt]$</prompt><command>/bin/bash</command>) or by the
35 <command>/bin/su</command> command. An interactive non-login shell is also
36 started with a terminal program such as <command>xterm</command> or
37 <command>konsole</command> from within a graphical environment. This type of
38 shell invocation normally copies the parent environment and then reads the
39 user's <filename>~/.bashrc</filename> file for additional startup configuration
40 instructions.</para>
41
42 <para>A non-interactive shell is usually present when a shell script is
43 running. It is non-interactive because it is processing a script and not
44 waiting for user input between commands. For these shell invocations, only
45 the environment inherited from the parent shell is used.</para>
46
47 <para> The file <filename>~/.bash_logout</filename> is not used for an
48 invocation of the shell. It is read and executed when a user exits from an
49 interactive login shell.</para>
50
51 <para>Many distributions use <filename>/etc/bashrc</filename> for system wide
52 initialization of non-login shells. This file is usually called from the
53 user's <filename>~/.bashrc</filename> file and is not built directly into
54 <command>bash</command> itself. This convention is followed in this
55 section.</para>
56
57 <para>For more information see <command>info bash</command> --
58 <emphasis role="strong">Nodes: Bash Startup Files and Interactive
59 Shells</emphasis>.</para>
60
61 <note>
62 <para>Most of the instructions below are used to create files located in
63 the <filename class='directory'>/etc</filename> directory structure which
64 requires you to execute the commands as the
65 <systemitem class='username'>root</systemitem> user. If you elect to create
66 the files in user's home directories instead, you should run the commands
67 as an unprivileged user.</para>
68 </note>
69
70 <sect2 id="etc-profile-profile">
71 <title>/etc/profile</title>
72
73 <indexterm zone="postlfs-config-profile etc-profile-profile">
74 <primary sortas="e-etc-profile">/etc/profile</primary>
75 </indexterm>
76
77 <para>Here is a base <filename>/etc/profile</filename>. This file starts by
78 setting up some helper functions and some basic parameters. It specifies some
79 <command>bash</command> history parameters and, for security purposes,
80 disables keeping a permanent history file for the <systemitem
81 class="username">root</systemitem> user. It also sets a
82 default user prompt. It then calls small, single purpose scripts in the
83 <filename class='directory'>/etc/profile.d</filename> directory to provide most
84 of the initialization.</para>
85
86 <para>For more information on the escape sequences you can use for your prompt
87 (i.e., the <envar>PS1</envar> environment variable) see <command>info
88 bash</command> -- <emphasis role="strong">Node: Printing a
89 Prompt</emphasis>.</para>
90
91<screen role="root"><?dbfo keep-together="auto"?><userinput>cat &gt; /etc/profile &lt;&lt; "EOF"
92<literal># Begin /etc/profile
93# Written for Beyond Linux From Scratch
94# by James Robertson &lt;jameswrobertson@earthlink.net&gt;
95# modifications by Dagmar d'Surreal &lt;rivyqntzne@pbzpnfg.arg&gt;
96
97# System wide environment variables and startup programs.
98
99# System wide aliases and functions should go in /etc/bashrc. Personal
100# environment variables and startup programs should go into
101# ~/.bash_profile. Personal aliases and functions should go into
102# ~/.bashrc.
103
104# Functions to help us manage paths. Second argument is the name of the
105# path variable to be modified (default: PATH)
106pathremove () {
107 local IFS=':'
108 local NEWPATH
109 local DIR
110 local PATHVARIABLE=${2:-PATH}
111 for DIR in ${!PATHVARIABLE} ; do
112 if [ "$DIR" != "$1" ] ; then
113 NEWPATH=${NEWPATH:+$NEWPATH:}$DIR
114 fi
115 done
116 export $PATHVARIABLE="$NEWPATH"
117}
118
119pathprepend () {
120 pathremove $1 $2
121 local PATHVARIABLE=${2:-PATH}
122 export $PATHVARIABLE="$1${!PATHVARIABLE:+:${!PATHVARIABLE}}"
123}
124
125pathappend () {
126 pathremove $1 $2
127 local PATHVARIABLE=${2:-PATH}
128 export $PATHVARIABLE="${!PATHVARIABLE:+${!PATHVARIABLE}:}$1"
129}
130
131export -f pathremove pathprepend pathappend
132
133# Set the initial path
134export PATH=/bin:/usr/bin
135
136if [ $EUID -eq 0 ] ; then
137 pathappend /sbin:/usr/sbin
138 unset HISTFILE
139fi
140
141# Setup some environment variables.
142export HISTSIZE=1000
143export HISTIGNORE="&amp;:[bf]g:exit"
144
145# Set some defaults for graphical systems
146export XDG_DATA_DIRS=/usr/share/
147export XDG_CONFIG_DIRS=/etc/xdg/
148
149# Setup a red prompt for root and a green one for users.
150NORMAL="\[\e[0m\]"
151RED="\[\e[1;31m\]"
152GREEN="\[\e[1;32m\]"
153if [[ $EUID == 0 ]] ; then
154 PS1="$RED\u [ $NORMAL\w$RED ]# $NORMAL"
155else
156 PS1="$GREEN\u [ $NORMAL\w$GREEN ]\$ $NORMAL"
157fi
158
159for script in /etc/profile.d/*.sh ; do
160 if [ -r $script ] ; then
161 . $script
162 fi
163done
164
165unset script RED GREEN NORMAL
166
167# End /etc/profile</literal>
168EOF</userinput></screen>
169
170 <sect3 id="etc-profile.d">
171 <title>The /etc/profile.d Directory</title>
172
173 <indexterm zone="postlfs-config-profile etc-profile.d">
174 <primary sortas="e-etc-profile.d">/etc/profile.d</primary>
175 </indexterm>
176
177 <para>Now create the <filename class='directory'>/etc/profile.d</filename>
178 directory, where the individual initialization scripts are placed:</para>
179
180<screen role="root"><userinput>install --directory --mode=0755 --owner=root --group=root /etc/profile.d</userinput></screen>
181
182 </sect3>
183
184 <sect3 id="etc-profile.d-dircolors.sh">
185 <title>/etc/profile.d/dircolors.sh</title>
186
187 <indexterm zone="postlfs-config-profile etc-profile.d-dircolors.sh">
188 <primary sortas="e-etc-profile.d-dircolors.sh">/etc/profile.d/dircolors.sh</primary>
189 </indexterm>
190
191 <para>This script uses the <filename>~/.dircolors</filename> and
192 <filename>/etc/dircolors</filename> files to control the colors of file names in a
193 directory listing. They control colorized output of things like <command>ls
194 --color</command>. The explanation of how to initialize these files is at the
195 end of this section.</para>
196
197<screen role="root"><userinput>cat &gt; /etc/profile.d/dircolors.sh &lt;&lt; "EOF"
198<literal># Setup for /bin/ls and /bin/grep to support color, the alias is in /etc/bashrc.
199if [ -f "/etc/dircolors" ] ; then
200 eval $(dircolors -b /etc/dircolors)
201
202 if [ -f "$HOME/.dircolors" ] ; then
203 eval $(dircolors -b $HOME/.dircolors)
204 fi
205fi
206alias ls='ls --color=auto'
207alias grep='grep --color=auto'</literal>
208EOF</userinput></screen>
209
210 </sect3>
211
212 <sect3 id="extrapaths.sh">
213 <title>/etc/profile.d/extrapaths.sh</title>
214
215 <indexterm zone="postlfs-config-profile extrapaths.sh">
216 <primary sortas="e-etc-profile.d-extrapaths.sh">/etc/profile.d/extrapaths.sh</primary>
217 </indexterm>
218
219 <para>This script adds some useful paths to the <envar>PATH</envar> and
220 can be used to customize other PATH related environment variables
221 (e.g. LD_LIBRARY_PATH, etc) that may be needed for all users.</para>
222
223<screen role="root"><userinput>cat &gt; /etc/profile.d/extrapaths.sh &lt;&lt; "EOF"
224<literal>if [ -d /usr/local/lib/pkgconfig ] ; then
225 pathappend /usr/local/lib/pkgconfig PKG_CONFIG_PATH
226fi
227if [ -d /usr/local/bin ]; then
228 pathprepend /usr/local/bin
229fi
230if [ -d /usr/local/sbin -a $EUID -eq 0 ]; then
231 pathprepend /usr/local/sbin
232fi
233
234# Set some defaults before other applications add to these paths.
235pathappend /usr/share/man MANPATH
236pathappend /usr/share/info INFOPATH</literal>
237EOF</userinput></screen>
238
239 </sect3>
240
241 <sect3 id="readline.sh">
242 <title>/etc/profile.d/readline.sh</title>
243
244 <indexterm zone="postlfs-config-profile readline.sh">
245 <primary sortas="e-etc-profile.d-readline.sh">/etc/profile.d/readline.sh</primary>
246 </indexterm>
247
248 <para>This script sets up the default <filename>inputrc</filename>
249 configuration file. If the user does not have individual settings, it uses the
250 global file.</para>
251
252<screen role="root"><userinput>cat &gt; /etc/profile.d/readline.sh &lt;&lt; "EOF"
253<literal># Setup the INPUTRC environment variable.
254if [ -z "$INPUTRC" -a ! -f "$HOME/.inputrc" ] ; then
255 INPUTRC=/etc/inputrc
256fi
257export INPUTRC</literal>
258EOF</userinput></screen>
259
260 </sect3>
261
262 <sect3 id="umask.sh">
263 <title>/etc/profile.d/umask.sh</title>
264
265 <indexterm zone="postlfs-config-profile umask.sh">
266 <primary sortas="e-etc-profile.d-umask.sh">/etc/profile.d/umask.sh</primary>
267 </indexterm>
268
269 <para>Setting the <command>umask</command> value is important for security.
270 Here the default group write permissions are turned off for system users and when
271 the user name and group name are not the same.</para>
272
273<screen role="root"><userinput>cat &gt; /etc/profile.d/umask.sh &lt;&lt; "EOF"
274<literal># By default, the umask should be set.
275if [ "$(id -gn)" = "$(id -un)" -a $EUID -gt 99 ] ; then
276 umask 002
277else
278 umask 022
279fi</literal>
280EOF</userinput></screen>
281
282 </sect3>
283
284<!-- This is handled in the Xorg section of the book
285 <sect3 id="X.sh">
286 <title>/etc/profile.d/X.sh</title>
287
288 <indexterm zone="postlfs-config-profile X.sh">
289 <primary sortas="e-etc-profile.d-X.sh">/etc/profile.d/X.sh</primary>
290 </indexterm>
291
292 <para>If <application>X</application> is installed, the <envar>PATH</envar>
293 and <envar>PKG_CONFIG_PATH</envar> variables are also updated.</para>
294
295<screen role="root"><userinput>cat &gt; /etc/profile.d/X.sh &lt;&lt; "EOF"
296<literal>if [ -x /usr/X11R6/bin/X ]; then
297 pathappend /usr/X11R6/bin
298fi
299if [ -d /usr/X11R6/lib/pkgconfig ] ; then
300 pathappend /usr/X11R6/lib/pkgconfig PKG_CONFIG_PATH
301fi</literal>
302EOF</userinput></screen>
303
304 </sect3>
305-->
306 <sect3 id="i18n.sh">
307 <title>/etc/profile.d/i18n.sh</title>
308
309 <indexterm zone="postlfs-config-profile i18n.sh">
310 <primary sortas="e-etc-profile.d-i18n.sh">/etc/profile.d/i18n.sh</primary>
311 </indexterm>
312
313 <para>This script sets environment variables necessary for
314 native language support.</para>
315
316<screen role="root"><userinput>cat &gt; /etc/profile.d/i18n.sh &lt;&lt; "EOF"
317<literal># Begin /etc/profile.d/i18n.sh
318
319unset LANG LC_CTYPE LC_NUMERIC LC_TIME LC_COLLATE LC_MONETARY LC_MESSAGES \
320 LC_PAPER LC_NAME LC_ADDRESS LC_TELEPHONE LC_MEASUREMENT LC_IDENTIFICATION
321
322if [ -n "$XDG_CONFIG_HOME" ] &amp;&amp; [ -r "$XDG_CONFIG_HOME/locale.conf" ]; then
323 . "$XDG_CONFIG_HOME/locale.conf"
324elif [ -r /etc/locale.conf ]; then
325 . /etc/locale.conf
326fi
327
328export LANG="${LANG:-C}"
329[ -n "$LC_CTYPE" ] &amp;&amp; export LC_CTYPE
330[ -n "$LC_NUMERIC" ] &amp;&amp; export LC_NUMERIC
331[ -n "$LC_TIME" ] &amp;&amp; export LC_TIME
332[ -n "$LC_COLLATE" ] &amp;&amp; export LC_COLLATE
333[ -n "$LC_MONETARY" ] &amp;&amp; export LC_MONETARY
334[ -n "$LC_MESSAGES" ] &amp;&amp; export LC_MESSAGES
335[ -n "$LC_PAPER" ] &amp;&amp; export LC_PAPER
336[ -n "$LC_NAME" ] &amp;&amp; export LC_NAME
337[ -n "$LC_ADDRESS" ] &amp;&amp; export LC_ADDRESS
338[ -n "$LC_TELEPHONE" ] &amp;&amp; export LC_TELEPHONE
339[ -n "$LC_MEASUREMENT" ] &amp;&amp; export LC_MEASUREMENT
340[ -n "$LC_IDENTIFICATION" ] &amp;&amp; export LC_IDENTIFICATION
341
342# End /etc/profile.d/i18n.sh</literal>
343EOF</userinput></screen>
344
345 </sect3>
346
347 <sect3>
348 <title>Other Initialization Values</title>
349
350 <para>Other initialization can easily be added to the
351 <filename>profile</filename> by adding additional scripts to the
352 <filename class='directory'>/etc/profile.d</filename> directory.</para>
353
354 </sect3>
355
356 </sect2>
357
358 <sect2 id="etc-bashrc-profile">
359 <title>/etc/bashrc</title>
360
361 <indexterm zone="postlfs-config-profile etc-bashrc-profile">
362 <primary sortas="e-etc-bashrc">/etc/bashrc</primary>
363 </indexterm>
364
365 <para>Here is a base <filename>/etc/bashrc</filename>. Comments in the
366 file should explain everything you need.</para>
367
368<screen role="root"><userinput>cat &gt; /etc/bashrc &lt;&lt; "EOF"
369<literal># Begin /etc/bashrc
370# Written for Beyond Linux From Scratch
371# by James Robertson &lt;jameswrobertson@earthlink.net&gt;
372# updated by Bruce Dubbs &lt;bdubbs@&lfs-domainname;&gt;
373
374# System wide aliases and functions.
375
376# System wide environment variables and startup programs should go into
377# /etc/profile. Personal environment variables and startup programs
378# should go into ~/.bash_profile. Personal aliases and functions should
379# go into ~/.bashrc
380
381# Provides colored /bin/ls and /bin/grep commands. Used in conjunction
382# with code in /etc/profile.
383
384alias ls='ls --color=auto'
385alias grep='grep --color=auto'
386
387# Provides prompt for non-login shells, specifically shells started
388# in the X environment. [Review the LFS archive thread titled
389# PS1 Environment Variable for a great case study behind this script
390# addendum.]
391
392NORMAL="\[\e[0m\]"
393RED="\[\e[1;31m\]"
394GREEN="\[\e[1;32m\]"
395if [[ $EUID == 0 ]] ; then
396 PS1="$RED\u [ $NORMAL\w$RED ]# $NORMAL"
397else
398 PS1="$GREEN\u [ $NORMAL\w$GREEN ]\$ $NORMAL"
399fi
400
401unset RED GREEN NORMAL
402
403# End /etc/bashrc</literal>
404EOF</userinput></screen>
405
406 </sect2>
407
408 <sect2 id="bash_profile-profile">
409 <title>~/.bash_profile</title>
410
411 <indexterm zone="postlfs-config-profile bash_profile-profile">
412 <primary sortas="e-AA.bash_profile">~/.bash_profile</primary>
413 </indexterm>
414
415 <para>Here is a base <filename>~/.bash_profile</filename>. If you want each
416 new user to have this file automatically, just change the output of
417 the command to <filename>/etc/skel/.bash_profile</filename> and check the
418 permissions after the command is run. You can then copy
419 <filename>/etc/skel/.bash_profile</filename> to the home directories of already
420 existing users, including <systemitem class="username">root</systemitem>,
421 and set the owner and group appropriately.</para>
422
423<screen><userinput>cat &gt; ~/.bash_profile &lt;&lt; "EOF"
424<literal># Begin ~/.bash_profile
425# Written for Beyond Linux From Scratch
426# by James Robertson &lt;jameswrobertson@earthlink.net&gt;
427# updated by Bruce Dubbs &lt;bdubbs@&lfs-domainname;&gt;
428
429# Personal environment variables and startup programs.
430
431# Personal aliases and functions should go in ~/.bashrc. System wide
432# environment variables and startup programs are in /etc/profile.
433# System wide aliases and functions are in /etc/bashrc.
434
435if [ -f "$HOME/.bashrc" ] ; then
436 source $HOME/.bashrc
437fi
438
439if [ -d "$HOME/bin" ] ; then
440 pathprepend $HOME/bin
441fi
442
443# Having . in the PATH is dangerous
444#if [ $EUID -gt 99 ]; then
445# pathappend .
446#fi
447
448# End ~/.bash_profile</literal>
449EOF</userinput></screen>
450
451 </sect2>
452
453 <sect2 id="bashrc-profile">
454 <title>~/.bashrc</title>
455
456 <indexterm zone="postlfs-config-profile bashrc-profile">
457 <primary sortas="e-AA.bashrc">~/.bashrc</primary>
458 </indexterm>
459
460 <para>Here is a base <filename>~/.bashrc</filename>. The comments and
461 instructions for using <filename class="directory">/etc/skel</filename> for
462 <filename>.bash_profile</filename> above also apply here. Only the target file
463 names are different.</para>
464
465<screen><userinput>cat &gt; ~/.bashrc &lt;&lt; "EOF"
466<literal># Begin ~/.bashrc
467# Written for Beyond Linux From Scratch
468# by James Robertson &lt;jameswrobertson@earthlink.net&gt;
469
470# Personal aliases and functions.
471
472# Personal environment variables and startup programs should go in
473# ~/.bash_profile. System wide environment variables and startup
474# programs are in /etc/profile. System wide aliases and functions are
475# in /etc/bashrc.
476
477if [ -f "/etc/bashrc" ] ; then
478 source /etc/bashrc
479fi
480
481# End ~/.bashrc</literal>
482EOF</userinput></screen>
483
484 </sect2>
485
486
487 <sect2 id="bash_logout-profile">
488 <title>~/.bash_logout</title>
489
490 <indexterm zone="postlfs-config-profile bash_logout-profile">
491 <primary sortas="e-AA.bash_logout">~/.bash_logout</primary>
492 </indexterm>
493
494 <para>This is an empty <filename>~/.bash_logout</filename> that can be used as
495 a template. You will notice that the base <filename>~/.bash_logout</filename>
496 does not include a <userinput>clear</userinput> command. This is because the
497 clear is handled in the <filename>/etc/issue</filename> file.</para>
498
499<screen><userinput>cat &gt; ~/.bash_logout &lt;&lt; "EOF"
500<literal># Begin ~/.bash_logout
501# Written for Beyond Linux From Scratch
502# by James Robertson &lt;jameswrobertson@earthlink.net&gt;
503
504# Personal items to perform on logout.
505
506# End ~/.bash_logout</literal>
507EOF</userinput></screen>
508
509 </sect2>
510
511
512 <sect2 id="etc-dircolors-profile">
513 <title>/etc/dircolors</title>
514
515 <indexterm zone="postlfs-config-profile etc-dircolors-profile">
516 <primary sortas="e-etc-dircolors">/etc/dircolors</primary>
517 </indexterm>
518
519 <indexterm zone="postlfs-config-profile etc-dircolors-profile">
520 <primary sortas="e-AA.dircolors">~/.dircolors</primary>
521 </indexterm>
522
523 <para> If you want to use the <filename>dircolors</filename> capability, then
524 run the following command. The <filename class="directory">/etc/skel</filename>
525 setup steps shown above also can be used here to provide a
526 <filename>~/.dircolors</filename> file when a new user is set up. As before,
527 just change the output file name on the following command and assure the
528 permissions, owner, and group are correct on the files created and/or
529 copied.</para>
530
531<screen role="root"><userinput>dircolors -p > /etc/dircolors</userinput></screen>
532
533 <para>If you wish to customize the colors used for different file types, you can
534 edit the <filename>/etc/dircolors</filename> file. The instructions for setting
535 the colors are embedded in the file.</para>
536
537
538 <para>Finally, Ian Macdonald has written an excellent collection of tips and
539 tricks to enhance your shell environment. You can read it online at
540 <ulink url="http://www.caliban.org/bash/index.shtml"/>.</para>
541
542 </sect2>
543
544</sect1>
Note: See TracBrowser for help on using the repository browser.