Guia de Referência de Funções

Desenvolvido por Renan Pessoa

Página do projeto
  1. Instalação

  2. Validação

  3. Informação

  4. Outros

Utilização


Descrição

Adiciona diversas funções que podem ser utilizadas nos scripts ou diretamente na linha de comando


Parâmetros

Nenhum.


Código


curl -skL https://raw.githubusercontent.com/renanpessoa/cPanel_Functions/master/functions.sh > 
/tmp/funcoes_externas.sh
[[ -z `cat /tmp/funcoes_externas.sh | grep Teste_Valida` ]] && 
{ echo -e "Não foi possível importar as funções externas.";exit;}
source /tmp/funcoes_externas.sh && rm -fr /tmp/funcoes_externas.sh;


Exemplo


#!/bin/bash

#. Importa funções externas .#
##################################
curl -skL https://raw.githubusercontent.com/renanpessoa/cPanel_Functions/master/functions.sh > 
/tmp/funcoes_externas.sh
[[ -z `cat /tmp/funcoes_externas.sh | grep Teste_Valida` ]] && 
{ echo -e "Não foi possível importar as funções externas.";exit;}
source /tmp/funcoes_externas.sh && rm -fr /tmp/funcoes_externas.sh;
##################################

while :;do

    echo -en "Informe o domínio: "
    read dominio
    func_valida_dominio $dominio    # <-- Utilizando função para validar o domínio informado.
    [[ `echo $?` == 0 ]] && break

done

echo "O domínio é válido, continuando as verificações..."



Comentários

Adicione o código de importação no inicio do script e em seguida utilize as funções ! Também é possível utilizar as funções diretamente no bash:

root@vps [~]# source <(curl -sk https://raw.githubusercontent.com/renanpessoa/cPanel_Functions/master/functions.sh)

root@vps [~]# func_citacao_aleatoria

O covarde só ataca quando está a salvo. Johann Goethe

root@vps [~]#

func_valida_dominio()


Descrição

func_valida_dominio <domínio>

Valida o domínio informado


Parâmetros

prefixo (opcional)
-s : Nenhuma mensagem de erro é retornada

domínio - o domínio a ser validado


Saída

Se for verdadeiro(válido) retorna 0

Se for falso retorna 1


Exemplos


while :;do

    echo -en "Informe o domínio: "
    read dominio
    func_valida_dominio $dominio
    [[ `echo $?` == 0 ]] && break # Se a funçao retornar 0, ou seja, se o domínio existir no servidor sai do loop e prossegue o script

done

echo "O domínio é válido, continuando as verificações..."



Comentários

No exemplo acima será realizado um loop solicitando o domínio até que seja informado um domínio válido. Após ler o domínio[read dominio] é chamado a função passando como parâmetro o domínio 'func_valida_dominio $dominio', caso o domínio seja verdadeiro o loop é interrompido '[[ `echo $?` == 0 ]] && break' e o código continua, caso contrário é executado novamente.

func_valida_usuario()


Descrição

func_valida_usuario <usuário>

Valida o usuário informado


Parâmetros

prefixo (opcional)
-s : Nenhuma mensagem de erro é retornada

usuário - o usuário a ser validado


Saída

Se for verdadeiro(válido) retorna 0

Se for falso retorna 1


Exemplos


while :;do

    echo -en "Informe o usuário: "
    read usuario
    func_valida_usuario $usuario
    [[ `echo $?` == 0 ]] && break

done

echo "O usuário é válido, continuando as verificações..."


Comentários

No exemplo acima será realizado um loop solicitando o usuário até que seja informado um usuário válido. Após ler o usuário[read usuario] é chamado a função passando como parâmetro o usuário 'func_valida_usuario $usuario', caso o usuario seja verdadeiro o loop é interrompido '[[ `echo $?` == 0 ]] && break' e o código continua, caso contrário é executado novamente.

func_valida_revendedor()


Descrição

func_valida_revendedor <revendedor>

Valida o revendedor informado


Parâmetros

prefixo (opcional)
-s : Nenhuma mensagem de erro é retornada

revendedor - o usuário a ser validado


Saída

Se for verdadeiro(válido) retorna 0

Se for falso retorna 1


Exemplos


while :;do

    echo -en "Informe o revendedor: "
    read revendedor
    func_valida_revendedor $revendedor
    [[ `echo $?` == 0 ]] && break

done

echo "O revendedor é válido, continuando as verificações..."


Comentários

No exemplo acima será realizado um loop solicitando o revendedor até que seja informado um usuário válido. Após ler o revendedor[read revendedor] é chamado a função passando como parâmetro o revendedor 'func_valida_revendedor $revendedor', caso o revendedor seja verdadeiro o loop é interrompido '[[ `echo $?` == 0 ]] && break' e o código continua, caso contrário é executado novamente.

func_usuario_info()


Descrição

func_usuario_info <usuário>

Exibe diversas informações sobre a conta


Exemplos


Código
---------------
echo -en "Informe o usuário: "
read usuario
func_usuario_info $usuario
---------------

Saída
---------------
root@vps [/home/renanpessoa]# bash infoacct.sh 
Informe o usuário: renanpessoa
Usuário: renanpessoa
Domínio: semdominio.com.br
Owner:   root
Pacote: essepacoteémeu
Disco utilizado: 50mb
Disco limite: unlimited
Revendor: Não
Suspensa: Não
IP: 127.0.0.1
Apontamento de DNS: Incorreto
Backup: Ativo 
Legacy Backup: Desativado 
root@vps [/home/renanpessoa]# 
---------------


Comentários

Esta função também pode ser utilizada na linha de comando, adicione um alias para o comando se preferir como por exemplo: alias infoacct='func_usuario_info', após isto basta executar 'infoacct $usuario' para conseguir diversas informações.

func_usuario_tamanho()


Descrição

func_usuario_tamanho <usuario>

Exibe o tamanho do home da conta em Megabytes (MB) de maneira instântania pois utiliza cache do servidor, caso o cache esteja desabilitado é calculado o tamanho.


Parâmetros

usuário


Saída

root@vps [~]# func_usuario_tamanho renanpessoa

39M /home/renanpessoa

root@vps [~]#


Exemplos


Código
---------------

read -p "Digite o usuário: " usuario;

echo -e "\nTamanho da conta: "
func_usuario_tamanho $usuario

---------------

Saída
---------------

root@vps [~]# bash tamanho.sh 
Digite o usuário: renanpessoa

Tamanho da conta: 
39M /home/renanpessoa
root@vps [~]#

--------------- 


Comentários

Utilizando esta função seu script não perde um tempão calculando o tamanho das contas pois o resultado é instantâneo, produtividade e desempenho! O resultado é em Megabytes (MB).

func_citacao_aleatoria()


Descrição

func_citacao_aleatoria

Exibe uma citação aleatória


Parâmetros

Nenhum


Saída

Uma citação aleatória


Exemplos



Código
---------------
f=$(func_citacao_aleatoria);

echo -e "Frase do dia: $f";
---------------

Saída
---------------
root@vps [/home/renanpessoa]# bash frase.sh 
Frase do dia: Um amigo é a pessoa a quem mais se dá crédito quando fala mal de nós. Jean Rostand
root@vps [/home/renanpessoa]# 
---------------


Comentários

A função gera uma citação aleátoria cade vez que é executada