Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 100715 - Guide for keeping system in top shape
Summary: Guide for keeping system in top shape
Alias: None
Product: [OLD] Docs-user
Classification: Unclassified
Component: Other (show other bugs)
Hardware: All Linux
: High enhancement (vote)
Assignee: Docs Team
Depends on:
Reported: 2005-07-29 07:37 UTC by Clock
Modified: 2005-07-30 07:42 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Note You need to log in before you can comment on or make changes to this bug.
Description Clock 2005-07-29 07:37:45 UTC
Keeping gentoo system in top shape is of vital importance for every user and
should be done properly from the very beginning.

I don't consider the current state of the documentation treating this topic
satisfactory. It resembles rather a philosophical tractate with million of ways
how to possibly solve various problems that can arise while attempting to keeping
the system in proper state.

I suggest a guide in the following style would be written instead, specially
covering keeping the system in shape:
1) Check if X and if not, perform magic operation Z from chapter Y
2) spit three times on the screen
3) if you are gay, then issue emerge --i-am-gay
4) if today is thursday, goto step (6)
5) emerge barfoo
6) check that version of toad is greater than version of stool
7) if you father's name is Terry, do /etc/portage/update.d --config --father-name
8) do ifconfig eth0 and write down 4th digit on the 2nd row of the ouput
9) do emerge --deep --throat --blow --job --always --really --purge --seriously
--update --whole-system --i-mean-it-seriously --im-not-joking
10) if you get conflict, run resolve-conflict --revdep-reconf N, where N is the
next prime higher than the version of the application that caused the conflict
and go back to (9)
11) run revdep-reconf --safe-sex --no-masturbation --perversions=off
12) if your CPU starts smoking, perform etc-update --all-packages and retry from
the step (5)
13) perform etc-update /etc/resolv.conf --digit=M, where M is the digit written
down in step (8).

Such a guide should be performable without thinking and actually written as
a program for CPU=human, programming language=english.

Otherwise novice users that don't understand gentoo properly or people who don't
have time to study the manuals will fuck up their systems at the very beginning.

Reproducible: Always
Steps to Reproduce:
1.Determine where keeping system in top shape is described
2.Try to put your system in top shape

Actual Results:  
Brain arrest

Expected Results:  
Guide through trained-monkey-simple steps by which the user doesn't need to do
actions more complicated that comparison of two strings on the screen or paper

Red hat or has a magic one-shot update button. I don't want gentoo to be
this lame, but I don't want to feel myself like performing exam from data
structures when trying to update my system.

Portage (default-linux/x86/2005.0, gcc-3.3.5-20050130, glibc-2.3.5-
r0, 2.6.11-gentoo-r9 i686)
System uname: 2.6.11-gentoo-r9 i686 Intel(R) Pentium(R) M processor 1.50GHz
Gentoo Base System version 1.6.13
dev-lang/python:     2.3.5
sys-apps/sandbox:    1.2.11
sys-devel/autoconf:  2.13, 2.59-r6
sys-devel/automake:  1.4_p6, 1.5, 1.6.3, 1.7.9-r1, 1.8.5-r3, 1.9.5
sys-devel/libtool:   1.5.18-r1
virtual/os-headers:  2.6.11-r2
CFLAGS="-O2 -march=pentium3 -fomit-frame-pointer -pipe"
CONFIG_PROTECT="/etc /usr/kde/2/share/config /usr/kde/3.3/env /usr/kde/3.3/share
/config /usr/kde/3.3/shutdown /usr/kde/3.4/env /usr/kde/3.4/share/config /usr/kd
e/3.4/shutdown /usr/kde/3/share/config /usr/lib/X11/xkb /usr/lib/mozilla/default
s/pref /usr/share/config /usr/share/texmf/dvipdfm/config/ /usr/share/texmf/dvips
/config/ /usr/share/texmf/tex/generic/config/ /usr/share/texmf/tex/platex/config
/ /usr/share/texmf/xdvi/ /var/qmail/control"
CONFIG_PROTECT_MASK="/etc/gconf /etc/terminfo /etc/env.d"
CXXFLAGS="-O2 -march=pentium3 -fomit-frame-pointer -pipe"
FEATURES="autoconfig distlocks sandbox sfperms strict"
USE="x86 X alsa apm arts avi berkdb bitmap-fonts cdr crypt cups curl emboss enco
de esd fam foomaticdb fortran gd gdbm gif gnome gpm gstreamer gtk gtk2 guile ima
gemagick imap imlib ipv6 jack java jpeg kde ldap libg++ libwww mad mikmod mng mo
tif mozilla mp3 mpeg mysql ncurses nls ogg oggvorbis opengl oss pam pdflib perl 
png python qt quicktime readline ruby samba sdl slang spell ssl svga tcltk tcpd 
tetex theora tiff tls truetype truetype-fonts type1-fonts vorbis xine xml2 xmms 
xv zlib userland_GNU kernel_linux elibc_glibc"
Comment 1 SpanKY gentoo-dev 2005-07-29 07:54:32 UTC
this request is kind of vague at best

what are you looking for exactly ?  some mini guide to hold a users hand in
getting the bare min done with portage ?
Comment 2 Jonathan Smith (RETIRED) gentoo-dev 2005-07-29 08:11:10 UTC
a general maintenence guide would be really fun to write. i volunteer if the doc
is wanted

on that note, it sounds like a good idea to me. things like portage maintenence
(--prune, --depclean, etc), clearing out useless files (/var/tmp/portage/*
anyone?), disk maintenence...
Comment 3 Wernfried Haas (RETIRED) gentoo-dev 2005-07-29 09:50:21 UTC
Assuming this is rather meant as a joke than an actual bugreport, i'd suggest
posting it on the forums. Stuff like that is always welcome in the Gentoo Chat
and OTW forums and keeps bugzilla clean. ;)
Comment 4 Sven Vermeulen (RETIRED) gentoo-dev 2005-07-30 07:42:43 UTC
If someone wants to write a general maintenance guide, that's fine, but make
sure to put your asbestos suit on because maintaining a system differs from
sysadmin to sysadmin.

Plain users would run emerge --sync, emerge -uDN world, dispatch-conf and let
the rest be. And if you want to put that in a separate guide, I'll smack you on
the head with Xavier's catfish because this is already in the Gentoo Handbook,
which seeing from #gentoo's traffic nobody reads anyway.