Capítulo 12. Programação

O comando "echo" tem de ser usado com os seguintes cuidados porque a implementação dele difere entre o integrado na shell e os comandos externos.

	Nota
	Apesar da opção "-n" não ser realmente sintaxe POSIX, geralmente é aceite.

	Dica
	Use o comando "printf" em vez do comando "echo" se precisar de embeber sequências de escape na string de saída.

Parâmetros de shell especiais são frequentemente usados no script shell.

As expansões de parâmetro básicas a lembrar são as seguintes.

Aqui, o símbolo ortográfico dois pontos ":" em todas estas operações é na realidade opcional.

Cada comando retorna um estado de saída que pode ser usado para expressões condicionais.

	Nota
	"0" no contexto condicional da shell significa "Verdadeiro", enquanto "0" no contexto condicional de C significa "Falso".

	Nota
	"[" é o equivalente do comando test, o qual avalia os seus argumentos até ao "]" como uma expressão condicional.

Os idiomas condicionais básicos a lembrar são os seguintes.

if [ <expressão_condicional> ]; then
 <se_sucesso_corre_este-comando>
else
 <se_não_sucesso_corre_este_comando>
fi

Aqui o "|| true" final foi necessário para assegurar que estes script de shell não termina acidentalmente nesta linha quando a shell é invocada com a flag "-e".

Os operadores de comparação Aritmética de inteiros na expressão regular são "-eq", "-ne", "-lt", "-le", "-gt" e "-ge".

Existem vários idiomas de ciclo para usar na shell POSIX.

	Dica
	A interacção numérica tipo linguagem C pode ser realizada a usar seq(1) como o gerador de "foo1 foo2 …".

	Dica
	Veja Secção 9.3.9, “Repetir um ciclo de comandos sobre ficheiros”.

A shell processa um script rudemente como a seguinte sequência.

Citações singulares (') dentro de aspas não têm efeito.

Executar "set -x" na shell ou invocar a shell com a opção "-x" faz a shell escrever todos os comandos executados. Isto é muito útil para depuração.

De modo a tornar o seu programa de shell o mais portável possível entre os sistemas Debian, é uma boa ideia limitar os programas utilitários àqueles disponibilizados pelos pacotes essenciais.

A interface de utilizador de um programa simples de shell pode ser melhorada a partir de interacção aborrecida pelos comandos echo e read para uma mais interactiva ao usar um dos chamados programas de diálogo, etc.

Aqui está um script simples que cria uma imagem ISO com dados RS02 fornecidos por dvdisaster(1).

#!/bin/sh -e
# gmkrs02 : Copyright (C) 2007 Osamu Aoki <osamu@debian.org>, Public Domain
#set -x
error_exit()
{
  echo "$1" >&2
  exit 1
}
# Initialize variables
DATA_ISO="$HOME/Desktop/iso-$$.img"
LABEL=$(date +%Y%m%d-%H%M%S-%Z)
if [ $# != 0 ] && [ -d "$1" ]; then
  DATA_SRC="$1"
else
  # Select diretory for creating ISO image from folder on desktop
  DATA_SRC=$(zenity --file-selection --diretory  \
    --title="Select the diretory tree root to create ISO image") \
    || error_exit "Exit on diretory selection"
fi
# Check size of archive
xterm -T "Check size $DATA_SRC" -e du -s $DATA_SRC/*
SIZE=$(($(du -s $DATA_SRC | awk '{print $1}')/1024))
if [ $SIZE -le 520 ] ; then
  zenity --info --title="Dvdisaster RS02" --width 640  --height 400 \
    --text="The data size is good for CD backup:\\n $SIZE MB"
elif [ $SIZE -le 3500 ]; then
  zenity --info --title="Dvdisaster RS02" --width 640  --height 400 \
    --text="The data size is good for DVD backup :\\n $SIZE MB"
else
  zenity --info --title="Dvdisaster RS02" --width 640  --height 400 \
    --text="The data size is too big to backup : $SIZE MB"
  error_exit "The data size is too big to backup :\\n $SIZE MB"
fi
# only xterm is sure to have working -e option
# Create raw ISO image
rm -f "$DATA_ISO" || true
xterm -T "genisoimage $DATA_ISO" \
  -e genisoimage -r -J -V "$LABEL" -o "$DATA_ISO" "$DATA_SRC"
# Create RS02 supplemental redundancy
xterm -T "dvdisaster $DATA_ISO" -e  dvdisaster -i "$DATA_ISO" -mRS02 -c
zenity --info --title="Dvdisaster RS02" --width 640  --height 400 \
  --text="ISO/RS02 data ($SIZE MB) \\n created at: $DATA_ISO"
# EOF

Pode desejar criar um lançador no ambiente de trabalho com um conjunto de comandos algo como "/usr/local/bin/gmkrs02 %d".

Um simples exemplo, "example.c" pode ser compilado com uma biblioteca "libm" num executável "run_example" com o seguinte.

$ cat > example.c << EOF
#include <stdio.h>
#include <math.h>
#include <string.h>

int main(int argc, char **argv, char **envp){
        double x;
        char y[11];
        x=sqrt(argc+7.5);
        strncpy(y, argv[0], 10); /* prevent buffer overflow */
        y[10] = '\0'; /* fill to make sure string ends with '\0' */
        printf("%5i, %5.3f, %10s, %10s\n", argc, x, y, argv[1]);
        return 0;
}
EOF
$ gcc -Wall -g -o run_example example.c -lm
$ ./run_example
        1, 2.915, ./run_exam,     (null)
$ ./run_example 1234567890qwerty
        2, 3.082, ./run_exam, 1234567890qwerty

Aqui, o "-lm" é necessário para ligar a biblioteca "/usr/lib/libm.so" do pacote libc6 para o sqrt(3). A biblioteca real está em "/lib/" com o nome de ficheiro "libm.so.6", o qual é uma ligação simbólica para "libm-2.7.so".

Olhe ao último parâmetro no texto resultante. Existem mais de 10 caracteres mesmo com "%10s" especificado.

O uso de funções de operação de memória de ponteiro sem verificações de limites como em sprintf(3) e strcpy(3), está descontinuado para prevenir exploits de sobrelotação do buffer que influenciam os efeitos de transbordo em cima. Em vez disso, use snprintf(3) e strncpy(3).

Como todos os binários instalados devem estar 'despidos' de símbolos no sistema Debian por predefinição, a maioria dos símbolos de depuração são removidos no pacote normal. De modo a depurar pacotes Debian com o gdb(1), ou os pacotes *-dbg correspondentes ou *-dbgsym precisam de ser instalados (ex. libc6-dbg no caso do libc6, coreutils-dbgsym no caso do coreutils).

Quando encontrar um crash num programa, é uma boa ideia enviar um relatório de bug com informação de backtrace copiada-e-colada.

O backtrace pode ser obtido com os seguinte passos.

No caso do programa congelar, pode travar o programa ao pressionar Ctrl-C no terminal que correr o gdb para obter o aviso do gdb.

	Dica
	Muitas vezes, vê um backtrace onde uma ou mais linhas do topo estão em "malloc()" ou "g_malloc()". Quando isto acontece, há grandes hipóteses do seu backtrace não ser muito útil. O modo mais fácil de encontrar alguma informação útil é definir a variável de ambiente "$MALLOC_CHECK_" para um valor de 2 (malloc(3)). Pode fazer isto enquanto corre o gdb ao fazer o seguinte.

 $ MALLOC_CHECK_=2 gdb hello

Se o programa do GNOME preview1 recebeu um erro do X, deverá ver a mensagem que a seguir.

O programa 'preview1' recebeu um erro do X Window System.

Neste caso, pode tentar correr o programa com "--sync" e quebrar a função "gdk_x_error" de modo a obter um backtrace.

Use o ldd(1) para encontrar uma dependência de um programa em bibliotecas com o seguinte.

$ ldd /bin/ls
        librt.so.1 => /lib/librt.so.1 (0x4001e000)
        libc.so.6 => /lib/libc.so.6 (0x40030000)
        libpthread.so.0 => /lib/libpthread.so.0 (0x40153000)
        /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)

Para que o ls(1) funcione num ambiente 'chroot', as bibliotecas em cima têm de estar disponíveis no seu ambiente 'chroot'.

Aqui estão várias ferramentas de detecção de fugas de memória em Debian.

Pode desassemblar código binário com o objdump(1) com o seguinte.

$  objdump -m i386 -b binary -D /usr/lib/grub/x86_64-pc/stage1

	Nota
	O gdb(1) pode ser usado para desmontar (desassemblar) código interativamente.

	Atenção
	Não substitua ficheiros do sistema com os seus programas compilados quando os instalar.

Debian não toca nos ficheiros em "/usr/local/" ou em "/opt". Portanto se compilar um programa a partir do código-fonte, instale-o em "/usr/local/" para que não interfira com o Debian.

$ cd src
$ ./configure --prefix=/usr/local
$ make
$ make install # isto coloca os ficheiros no sistema

Se tiver a fonte original e esta utilizar autoconf(1)/automake(1) e se se lembrar como o configurou, execute como o seguinte para desinstalar o programa.

$ ./configure "todas-as-opções-que-fornecer"
# make uninstall

Em alternativa, se tiver a absoluta certeza que o processo de instalação apenas coloca ficheiros sob "/usr/local/" e não há lá nada importante, pode apagar todos os seus conteúdos com o seguinte.

# find /usr/local -type f -print0 | xargs -0 rm -f

Se não tiver a certeza de onde os ficheiros estão instalados, deve considerar usar o checkinstall(8) do pacote checkinstall, que disponibiliza um caminho limpo para a desinstalação. Agora suporta criar um pacote Debian com a opção "-D".