Seja Elegante

Talvez possa ser algo que passe despercebido por vários desenvolvedores, porém dúvido quem nunca tenha se deparado com mensagens de “log” vagas ou sem nenhum nexo ou bem pior, como mensagens idênticas replicadas por várias partes do código!
A algum tempo atrás estava trabalhando em um projeto em que um respectivo desenvolvedor da equipe possuia o costume de espalhar ou replicar centenas de printf() pelo código com mensagens tipo!

printf(“!!! FULANO – Aqui!!!”);

ou

printf(“!!! FULANO – Arquivo.cpp:  Aqui!!!\n”);

Precisa falar que isto e pessímo? Certo que e preciso um bom senso com o uso de mensagens de depuração pois dependendo ao invés de ajudar podem só atrapalhar. principalmente quando você necessita ter controle sobre tais mensagens, como por exemplo obter a localização da mensagem através do nome da função, arquivo e linha.

O pré-processador do GCC oferece (*) várias macros, as que irei utilizar em questão são:

• __FILE__ : Substituída pelo nome do arquivo.
• __PRETTY_FUNCTION__ : Substituídas pelo nome nome da função.
• __LINE__ : Substituída pelo número da linha de código.

(*) Mais detalhes sobre as macros do GCC.

A utilização dessas macros irá facilitar a localização das mensagens de depuração, Abaixo um simples exemplo demonstrado em debug1.c.

/**
 * By Jorge Pereira <jpereiran@gmail.com>
 * Date: Tue Jun 29 02:51:44 BRT 2010
 */

#include <stdio.h>
#include <unistd.h>
#include <stdlib.h>
#include <string.h>

// Macro condicional
#ifdef DEBUG
#	warning "Debug is enabled"
#	define TRACE_DEBUG(fmt, ...) \
	fprintf(stderr, " ** DEBUG: %s:%d %s(): "fmt"\n", \
	__FILE__, __LINE__, __PRETTY_FUNCTION__, ##__VA_ARGS__)
#else
#	warning "Debug is disabled"
#	define TRACE_DEBUG(fmt, ...)
#endif

#define MAX_STRING 5 /* tamanho maximo de uma string */

// Função simples de exemplo...
void
show_name (const char* name,
		   size_t len)
{
	size_t offset = len;

	// Verificação qualquer...
	if (len > MAX_STRING)
	{
		// Abaixo mensagem de depuração, perceba que ela será ativada apenas
                // quando em tempo de compilação você ativar a macro "DEBUG"
		TRACE_DEBUG ("Ooops! Tamanho da string(%d) e excedeu o limite(%d)...",
			len, MAX_STRING);
		offset = MAX_STRING;
	}

	// Manipulação qualquer...
	write (STDOUT_FILENO, name, offset);
	write (STDOUT_FILENO, "\n", 1);
}

int
main (int argc, char* argv[])
{
	if (argc < 2)
	{
		printf ("Usage: %s <string>\n", argv[0]);
		exit (1);
	}

	show_name (argv[1], strlen (argv[1]));

	return 0;
}

Com este exemplo básico em mãos, vamos compilar e executar.

[jpereira@miracleworld Codes]$ gcc -Wall -o debug1 debug1.c
debug1.c:18:3: warning: #warning "Debug is disabled"
[jpereira@miracleworld Codes]$ ./debug1 "Jorge"
Jorge
[jpereira@miracleworld Codes]$ ./debug1 "Jorge Pereira"
Jorge
[jpereira@miracleworld Codes]$

Imagine que seu sistema possui inúmeros arquivos e você precisa em determinados pontos obter o máximo de informação sobre as mensagens de depuração, talvez seja interessante ter além de uma mensagem objetiva obter juntamente o nome da função, arquivo e linha de onde foi invocada tal mensagem.

[jpereira@miracleworld Codes]$ gcc -Wall -DDEBUG -o debug1 debug1.c
debug1.c:13:3: warning: #warning "Debug is enabled"
[jpereira@miracleworld Codes]$ ./debug1 "Jorge"
Jorge
[jpereira@miracleworld Codes]$ ./debug1 "Jorge Pereira"
 ** DEBUG: debug1.c:36 show_name(): Ooops! Tamanho da string(13) e excedeu o limite(5)...
Jorge
[jpereira@miracleworld Codes]$

Lembrando que este e o primeiro post entre vários que pretendo publicar relacionados a sugestões e técnicas de depuração. Fique de olho na segunda parte desta saga em que irei explicar uma mais dinâmica do mesmo assunto abordado neste post associando ao uso de variáveis de ambiente.
Dúvidas e Sugestões, são sempre bem vindas!

Autor: Jorge Pereira

Porém no mês passado resolvi comprar um novo notebook que fosse preferencialmente da Sony, e após várias buscas cheguei ao modelo VPC-EB15FB. Então fui ao shopping e comprei diretamente na loja da SonyStyle o brinquedinho abaixo.

Assim que cheguei em casa fiz o download do Ubuntu 9.10 e instalei, após o primeiro boot que iniciei a configuração e recuperação dos meus backups do notebook antigo percebi que algumas teclas de atalhos não funcionaram, estranho né? Abaixo imagem das teclas na qual estou me referindo.

Obviamente que não fiquei de braços cruzados, fiz checkout diretamente pelo GIT do Kernel o modulo “platform-drivers-x86” e após alguns ajustes já estava adicionado o suporte das novas teclas da série EB de notebooks da Sony ao Kernel do Linux.

Resumindo, suporte adicionado seguido de patch gerado e submetido ao Kernel. Agora e aguardar a próxima versão do Kernel para termos por padrão o suporte a tais teclas!

Patch gerado a partir do Kernel 2.6.35-rc3

Caso você tenha necessidade ou curiosidade em relação a Device Drivers no Linux, este com certeza será um bom material para iniciar-se na “brincadeira”.

Introdução aos Linux Device Drivers (ILDD) é um curso que tem por objectivo apresentar os princípios básicos do desenvolvimento de device drivers no Linux kernel. Pretende-se com este curso, que o leitor tenha contacto com várias ferramentas e sub-sistemas existentes no kernel, adquirindo assim as bases que lhe irão permitir desenvolver o suporte para a grande maioria dos dispositivos. Alguns dos temas introduzidos são: estrutura básica de um device driver, comunicação com o userspace, memória dinâmica, eventos assíncronos, primitivas de sincronização e comunicação com o hardware.

Este curso aborda o tema de uma perspectiva pedagógica, através da sistematização dos conceitos em conjunto com uma forte componente prática, na qual se convida o leitor à implementação gradual de um device driver que dará suporte a um dispositivo especificamente concebido para o efeito. O leitor poderá ainda consultar a literatura de referência, de onde se destacam os excelentes títulos: Linux Device Drivers, Understanding the Linux Kernel e Linux Kernel in a Nutshell.

O autor, com a ajuda dos seus revisores, investiu mais de um ano de trabalho na elaboração e preparação deste curso, no sentido de oferecer à comunidade, não só um manual de aprendizagem abrangente, mas também uma importante referência futura. Caso encontre alguns erros ou tenha sugestões que visam melhorar ou complementar este trabalho, não hesite em contactar o autor.

Download aqui

Fiz várias pesquisas sobre o teclado e seu funcionamento nos Nokia Internet tablets N8xx e assim como outros inúmeros teclados do gênero ele possui um esquema de mapas diferente sendo incompatível com os esquemas de HID convencionais, foi durante a pesquisa que cheguei a um serviço chamado “kbdd“.

O kbdd e um daemon que funciona na camada de usuário “user-space”, sendo responsável pela comunicação atráves da interface serial (over irda/bluetooth/…) do teclado fazendo o intermedio para a camada de input do kernel utilizando o modulo uinput nativo no Kernel, e assim encaminhando as teclas para o S.O.

Ele foi feito direcionado para plataformas móveis como maemo, openmoko, gpe, entre outros. Pois caso você tenha algum teclado do tipo e o esquema de maps dele seja suportado conforme lista descrita no site do kbdd, basta seguir os passos a seguir!

1) Baixe o código a partir do CVS e compile.

[jpereira@jiraya ~]$ mkdir -p ~/tmp/kbdd
[jpereira@jiraya ~]$ cd ~/tmp/kbdd/
[jpereira@jiraya kbdd]$ export CVSROOT=":pserver:anoncvs@anoncvs.handhelds.org:/cvs"
[jpereira@jiraya kbdd]$ cvs login
Logging in to :pserver:anoncvs@anoncvs.handhelds.org:2401/cvs
CVS password: anoncvs
[jpereira@jiraya kbdd]$ cvs co apps/kbdd
[jpereira@jiraya kbdd]$ cd apps/kbdd/
[jpereira@jiraya kbdd]$ make

2) Ative o esquema de “discovery” do teclado, e no Linux inicie a busca pelo dispositivo em seguida atache o endereço MAC do seu teclado bluetooth a uma porta serial e em seguida inicialize o serviço. (Quando pedir a senha do bluetooth, utilize a senha padrão dele “0000″)

[jpereira@jiraya kbdd]$ sudo hcitool scan
Scanning ...
00:0A:3A:06:09:B0       BT-FoldableKB
[jpereira@jiraya kbdd]$ sudo rfcomm bind 0 00:0A:3A:06:09:B0
[jpereira@jiraya kbdd]$ sudo modprobe uinput
[jpereira@jiraya kbdd]$ ./kbdd -p /dev/rfcomm0 -t btfoldable &

OBS: Fiz diversas alterações no kbdd, inclusive adicionei a possibilidade de iniciar o kbdd como daemon, adicionei flag de compilação para o N770, entre outras coisas. Caso queira utilizar a versão alterada basta aplicar este patch. Inclusive conversei  com um dos autores por e-mail que retornou positivamente as melhorias feitas no kbdd, creio que logo mais já vai estar disponível no cvs do projeto tais alterações! Assim que eu receber meu N800 e tiver com tempinho livre vou trabalhar nele para melhorar outras coisas, inclusive a possibilidade de uso do D-bus na comunicação com a parte de input das teclas!

Abaixo segue os passos para caso queira experimentar a versão alterada!

[jpereira@jiraya ~]$ mkdir -p ~/tmp/kbdd
[jpereira@jiraya ~]$ cd ~/tmp/kbdd/
[jpereira@jiraya kbdd]$ export CVSROOT=":pserver:anoncvs@anoncvs.handhelds.org:/cvs"
[jpereira@jiraya kbdd]$ cvs login
Logging in to :pserver:anoncvs@anoncvs.handhelds.org:2401/cvs
CVS password: anoncvs
[jpereira@jiraya kbdd]$ cvs co apps/kbdd
[jpereira@jiraya kbdd]$ cd apps/kbdd/
[jpereira@jiraya kbdd]$ wget http://blog.jorgepereira.com.br/wp-content/dist/patchs/kbdd-jorgepereira.patch
[jpereira@jiraya kbdd]$ patch -p0 < kbdd-jorgepereira.patch
[jpereira@jiraya kbdd]$ make HAVE_FORK=1
[jpereira@jiraya kbdd]$ ./kbdd -p /dev/rfcomm0 -t btfoldable -b

Mesmo sendo um evento voltado mais para o público corporativo conseguiu ser de grande qualidade o espaço reservado para assuntos voltados ao Software Livre, uma estrutura muito legal com salas confortáveis e equipamentos de primeira linha em todos auditórios, resumindo! o evento foi muito legal!

Sem falar que por ter sido convidado fiquei praticamente uma semana de férias em alagoas no hotel Ponta Verde que foi custeado pela organização do evento, tive a oportunidade de rever meu grande brother Jonh Wendell que me deu grande suporte para me situar pela cidade, pois até então nunca havia ido a Maceió!

Vista do elevador panorâmico do hotel, que vidinha +/-!

Eu, Karlisson e o Jonh durante abertura do evento no auditório!

Rodizio de carnes básico!

Inovação Acadêmica e Projetos de Software Livre

Conforme foi me passado que o evento seria algo mais corporativo, procurei abordar os principais pontos relacionados sobre O Linux em Sistemas Móveis e Embarcados, link para o slide aqui.

Resumindo, a cidade e bem tranquila com praias bem legais… vários barzinhos entre eles o tão falado Maikai! Conheci o cara das tirinhas do nerdson.com, grande Karlisson… além de ter conhecido uma outra grande figura o famoso Cárlisson, cara responsável por criar diversos repentes bem legais!

Parabenizar a todos envolvidos no evento e espero ser convidado novamente para a próxima edição em 2010!

Entre a coleção de velharia eu encontrei a “Revista do Linux” (Edição 1° – 1999) guardadinha sem nenhum amasso acompanhada de mais diversas edições, assim como tantas outras edições “PC Master”. Essas revistas eram a agrande salvação pois sempre acompanhava uma distribuições diferente a cada edição!

1999 – Edição 1°  da “Revista do Linux”

1998 – Edição 1° da revista Portuguesa “Linux Actual”.

Mídias do Fedora Core 1, RedHat 6.0/6.2, Ubuntu 4.10 (Primeira versão) e o Debian 2.rc2

Mídia original do “Conectiva Linux 5.0″

Lembro que no inicio de tudo quando resolvi aprender sobre Linux foi necessário muitas madrugadas… muita ralação para aprender sobre particionamento, utilização do fips, problemas com gerenciamento de memória, lembro que fiquei por volta de dois meses somente usando o terminal pois não existia driver para minha placa de video sis650, sem esquecer das várias brigas com o modem hsp56 pctel para tentar entrar na internet, etc…etc… depois de tudo isso chego a conclusão que estou ficando velho ou tempo que passou muito rápido?

Abraços!

Complementando o post que fiz falando sobre o evento em  Setembro do ano passado, aqui estou eu novamente! Escrevendo mais uma vez sobre o BossaConference. Pois estando a menos de duas semanas de um dos melhores eventos da atualidade relacionado a assuntos do mundo OpenSource, mais uma vez indo prestigiar o evento através da empresa que trabalho juntamente com um companheiro de trabalho chamado Fábio Urquiza, estaremos lá logo mais!! Interessante que nesta edição irá ter inicio no dia 08/03, dia do meu aniversário! bem que poderia ter ganho a inscrição VIP por ser aniversariante!

Detalhe que a algum tempo atrás estava conversando sobre o evento com o Gustavo Noronha (kov) e ele havia ficado de se organizar para vir para o evento. Quando foi a algumas semanas atrás ele disse que viria, combinamos para ficar no mesmo hotel, e como estarei partindo no próximo dia 07/03 combinei de ir buscar ele no Aeroporto e de lá partir para Porto de Galinhas(local do evento). Como durante esses dias Recife e demais regiões tem recebido fortes pancadas de chuvas, espero que ao menos no sábado tenhamos um dia com muito sol para aproveitar a praia comendo peixe frito com algumas Skols bem gelada!

Para aqueles que forem, nos vemos lá!

OBS: Caso você queira ir para o evento com um desconto na faixa pagando apenas R$150, entre em contato RAPIDAMENTE com um amigo chamado Jesus <jesus.palencia@openbossa.org>, ele irá lhe ajudar! (Não e zueira, o nome dele realmente e Jesus! )

Glibc x uClibc

Justamente a minha necessidade foi diferente, estava precisando em algum momento verificar se um determinado executável estava em execução na lista de processos, foi desta forma que baixei o código fonte do pacote procps e fui da uma olhada para entender sua API que por sinal não existe nenhuma documentação! isto mesmo, existe apenas o pacote procps e o procps-devel que possui os headers utilizado para a acessar os métodos existentes na libproc (geralmente em /lib/libproc.so) conforme abaixo.

[jpereira@jiraya codes]$ ls -1 /usr/include/procps/
alloc.h
devname.h
escape.h
procps.h
pwcache.h
readproc.h
sig.h
slab.h
sysinfo.h
version.h
wchan.h
whattime.h
[jpereira@jiraya codes]$

Desta forma segue um simples código de exemplo utilizado para verificar se o programa especifico passado como parâmetro está em execução.

/**
 * Autor: Jorge Pereira <jpereiran@gmail.com>
 * Data:  Ter Jan 13 14:29:29 BRST 2009
 * Desc:  Simples aplicacao utilizada para verificar se existe um
 * processo em execucao utilizando a procps (libproc)
 *
 * Build: gcc -o checkps checkps.c -lproc
 **/
#include <string.h>
#include <stdio.h>
#include <stdlib.h>
#include <stddef.h>
#include <stdbool.h>

#include <readproc.h>

bool check_process(const char *proc)
{
	int32_t flags = 0;
	PROCTAB *ptp  = NULL;
	bool 	 st   = false;
	proc_t task;

	memset(&task, 0, sizeof (task));

	if (!proc || strlen(proc) < 1)
		return false;

	flags = PROC_FILLCOM | PROC_FILLSTATUS;

	if ((ptp = openproc (flags)) == NULL)
		return false;

	while(!st && readproc(ptp, &task))
	{
        const char *cmd = (task.cmdline != NULL) ? task.cmdline[0] : task.cmd;

		st = !strncmp(proc, cmd, strlen(proc));
		memset (&task, 0, sizeof (task));
	}

	closeproc (ptp);

    return st;
}

int main (int argc, char *argv[])
{
    if (argc < 2)
    {
        printf ("Usage: %s <nome do processo>\n", argv[0]);
        exit(EXIT_SUCCESS);
    }

    printf("O Programa (%s) %sesta em execucao\n", argv[1], check_process(argv[1]) ? "" : "nao ");

    return EXIT_SUCCESS;
}

Baixando este código de exemplo, compilando e fazendo uma checagem se existe o processo “dbus-launch” em execução!

[jpereira@jiraya tmp]$ wget http://blog.jorgepereira.com.br/jorge/wp-content/uploads/2009/01/checkps.c
[jpereira@jiraya tmp]$ gcc -o checkps checkps.c -lproc
[jpereira@jiraya tmp]$ ./checkps dbus-launch
O Programa (dbus-launch) está em execução
[jpereira@jiraya tmp]$ ./checkps dbus-lanche
O Programa (dbus-lanche) não está em execução
[jpereira@jiraya tmp]$

• Mais informações sobre o procps

1) Devemos utilizar a variável de ambiente LD_DEBUG, primeiramente iremos utilizar passando o parâmetro help para em seguida utilizar de acordo com a necessidade!

[root@jiraya ~]# export LD_DEBUG=help
[root@jiraya ~]# ls
Valid options for the LD_DEBUG environment variable are:

libs        display library search paths
reloc       display relocation processing
files       display progress for input file
symbols     display symbol table processing
bindings    display information about symbol binding
versions    display version dependencies
all         all previous options combined
statistics  display relocation statistics
unused      determined unused DSOs
help        display this help message and exit

To direct the debugging output into a file instead of standard output
a filename can be specified using the LD_DEBUG_OUTPUT environment variable.
[root@localhost ~]# export LD_DEBUG=libs
[root@localhost ~]# ls
5957:     find library=librt.so.1 [0]; searching
5957:      search cache=/etc/ld.so.cache
5957:       trying file=/lib/i686/librt.so.1
5957:
5957:     find library=libacl.so.1 [0]; searching
5957:      search cache=/etc/ld.so.cache
5957:       trying file=/lib/libacl.so.1
5957:
5957:     find library=libc.so.6 [0]; searching
5957:      search cache=/etc/ld.so.cache
5957:       trying file=/lib/i686/libc.so.6
5957:
5957:     find library=libpthread.so.0 [0]; searching
5957:      search cache=/etc/ld.so.cache
5957:       trying file=/lib/i686/libpthread.so.0
5957:
5957:     find library=libattr.so.1 [0]; searching
5957:      search cache=/etc/ld.so.cache
5957:       trying file=/lib/libattr.so.1
5957:
5957:
5957:     calling init: /lib/i686/libpthread.so.0
5957:
5957:
5957:     calling init: /lib/i686/libc.so.6
5957:
5957:
5957:     calling init: /lib/libattr.so.1
5957:
5957:
5957:     calling init: /lib/libacl.so.1
5957:
5957:
5957:     calling init: /lib/i686/librt.so.1
5957:
5957:
5957:     initialize program: ls
5957:
5957:
5957:     transferring control: ls
5957:
5957:     find library=libnss_files.so.2 [0]; searching
5957:      search cache=/etc/ld.so.cache
5957:       trying file=/lib/libnss_files.so.2
5957:
5957:
5957:     calling init: /lib/libnss_files.so.2
5957:
bin  get  hdparm.sh  he  he.c  seeker  src  tmp
[root@localhost ~]#

2) Caso queira enviar a saída da depuração para um arquivo, basta utilizar a variável de ambiente LD_DEBUG_OUTPUT, abaixo um exemplo de uma depuração completa com o modo all seguido de toda saída sendo enviada para o arquivo ls-debug-calls.log

[root@jiraya ~]# export LD_DEBUG_OUTPUT=ls-debug-calls.log
[root@jiraya ~]# export LD_DEBUG=all
[root@jiraya ~]# ls

3) Para desativar, basta simplesmente remover a variável de ambiente LD_DEBUG e se for o caso também a LD_DEBUG_OUTPUT

[root@jiraya ~]# unset LD_DEBUG
[root@jiraya ~]# unset LD_DEBUG_OUTPUT
[root@jiraya ~]# ls

Mais informações podem ser encontradas em Program-Library-HOWTO

Alguns clássicos da cultura, história e literatura de C seria o famoso [2]. Assim como um outros mais genéricos [3][4] que inclui alguns clássicos do C++ e do OOP.

Porém o POST e específico sobre desenvolvimento Unix, a principio podemos começar por Filosofia Unix e lembrando que nos dias de hoje sempre estamos trabalhando com softwares e suas diversas licenças, sendo muito interessante e indispensável o conhecimento sobre as principais licenças[5] de softwares!

[1] The Ten Commandments for C Programmers
[2] Programming in C
[3] http://www.mycplus.com/Programming-Tutorials-Index.asp
[4] http://www.di-mgt.com.au/cprog.html
[5] http://blog.jorgepereira.com.br/2006/10/15/entendendo-o-softwarelivre/

Acredito que todos que trabalham com desenvolvimento utilizando o Linux, já precisaram depurar algum trecho de código, e todos sabem que para quem não tem muito costume ele não e muito “amigável”. então segue abaixo link com tutorial e alguns arquivos de configuração contendo atalhos entre outras funções que com certeza irá ajudar muito na hora de depurar.

Abaixo segue alguns exemplos de configuração do GDB, lembrando que deverá ser salvo em ~/.gdbinit, caso queira ter como configuração padrão. do contrário basta utilizar o gdb passando o parâmetro -command,

Ex: gdb -command=gdbinit.txt

• http://www.kernsh.org/repo/gdbinit.txt
• http://tinderbox.x86.dev.gentoo.org/misc/dot.gdbinit
• http://dotfiles.org/~mkfs/.gdbinit

Excelentes tutoriais sobre GDB

• http://www.linuxtopia.org/online_books/redhat_linux_debugging_with_gdb/
• http://www.dirac.org/linux/gdb/
• http://www.arl.wustl.edu/~fredk/Courses/Docs/gdb.pdf
• http://www.arl.wustl.edu/~fredk/Courses/Docs/gdb_refcard.pdf
• http://www.arl.wustl.edu/~fredk/Courses/Docs/gdbint.pdf

root@jaspion ~ # history | awk ‘{ a[$2]++ } END{ for(i in a) { print a[i] ” ” i} }’ | sort -rn | head
69 ls
48 cat
34 cd
29 rm
21 ps
21 gcc
21 apt-get
19 vi
16 apt-search
14 sudo
root@jaspion ~ #

• Port Windows IPC apps to Linux, Part 1, 2 e 3

Para quem não saiba o que e IPC, basta da uma olhada aqui.