source é um comando interno do shell bash que executa o conteúdo do arquivo passado como argumento < strong> no shell atual . Tem um sinônimo em . (período).
Syntax
. filename [arguments] source filename [arguments]
$ whatis source
source: nothing appropriate.
$ man source
No manual entry for source
$ source
bash: source: filename argument required
source: usage: source filename [arguments]
Existe e é executável. Por que não há documentação sobre isso no Ubuntu? O que isso faz? Como posso instalar documentação sobre isso?
source é um comando interno do shell bash que executa o conteúdo do arquivo passado como argumento < strong> no shell atual . Tem um sinônimo em . (período).
Syntax
. filename [arguments] source filename [arguments]
Tenha cuidado! ./ e source são não exatamente iguais .
./script executa o script como um arquivo executável, iniciando um novo shell para executá-lo source script lê e executa comandos do nome do arquivo no ambiente atual do shell Observação: ./script não é . script , mas . script == source script
É útil conhecer o comando 'type':
> type source
source is a shell builtin
sempre que algo é um shell embutido, é hora de fazer man bash .
(um período) é um comando interno do shell bash que executa os comandos de um arquivo passado como argumento, no shell atual. 'source' é um sinônimo para '.'.
Da página de manual do Bash:
. filename [arguments]
source filename [arguments]
Read and execute commands from filename in the current shell
environment and return the exit status of the last command exe‐
cuted from filename. If filename does not contain a slash, file
names in PATH are used to find the directory containing file‐
name. The file searched for in PATH need not be executable.
When bash is not in posix mode, the current directory is
searched if no file is found in PATH. If the sourcepath option
to the shopt builtin command is turned off, the PATH is not
searched. If any arguments are supplied, they become the posi‐
tional parameters when filename is executed. Otherwise the
positional parameters are unchanged. The return status is the
status of the last command exited within the script (0 if no
commands are executed), and false if filename is not found or
cannot be read.
'source' é a versão longa de '.' comando. No prompt bash, pode-se fazer:
source ~/.bashrc
para recarregar sua configuração de bash (alterada?) para o bash atual.
Versão curta seria:
. ~/.bashrc
A página do manual:
. filename [arguments]
source filename [arguments]
Read and execute commands from filename in the current shell environment and
return the exit status of the last command executed from filename. If
filename does not contain a slash, file names in PATH are used to find the
directory containing filename. The file searched for in PATH need not be
executable. When bash is not in posix mode, the current directory is
searched if no file is found in PATH. If the sourcepath option to the short
builtin command is turned off, the PATH is not searched. If any arguments
are supplied, they become the positional parameters when filename is
executed. Otherwise the positional parameters are unchanged. The return
status is the status of the last command exited within the script (0 if no
commands are executed), and false if filename is not found or cannot be
read.
O comando source executa o script fornecido (a permissão executável é não obrigatória ) no ambiente shell atual , enquanto ./ executa o script executável fornecido em um shell novo .
source tem um sinônimo . filename .
Para deixar isso mais claro, dê uma olhada no seguinte script, que define o alias.
#! /bin/bash
alias myproject='cd ~/Documents/Projects/2015/NewProject'
Agora temos duas opções para executar este script. Mas com somente uma opção, o alias desejado para o shell atual pode ser criado entre essas duas opções.
./make_alias
Torne o script executável primeiro.
chmod +x make_alias
./make_alias
alias
**nothing**
Opa! O alias desapareceu com o novo shell.
Vamos com a segunda opção.
source make_alias
source make_alias
ou
. make_alias
alias
alias myproject='cd ~/Documents/Projects/2015/NewProject'
Sim o alias está definido.
Em caso de dúvida, o melhor a fazer é usar o comando info :
[root@abc ~]# info source
BASH BUILTIN COMMANDS
Unless otherwise noted, each builtin command documented in this section
as accepting options preceded by - accepts -- to signify the end of the
options. The :, true, false, and test builtins do not accept options
and do not treat -- specially. The exit, logout, break, continue, let,
and shift builtins accept and process arguments beginning with - with-
out requiring --. Other builtins that accept arguments but are not
specified as accepting options interpret arguments beginning with - as
invalid options and require -- to prevent this interpretation.
: [arguments]
No effect; the command does nothing beyond expanding arguments
and performing any specified redirections. A zero exit code is
returned.
. filename [arguments]
source filename [arguments]
Read and execute commands from filename in the current shell
environment and return the exit status of the last command exe-
cuted from filename. If filename does not contain a slash, file
names in PATH are used to find the directory containing file-
name. The file searched for in PATH need not be executable.
When bash is not in posix mode, the current directory is
searched if no file is found in PATH. If the sourcepath option
to the shopt builtin command is turned off, the PATH is not
searched. If any arguments are supplied, they become the posi-
tional parameters when filename is executed. Otherwise the
positional parameters are unchanged. The return status is the
status of the last command exited within the script (0 if no
commands are executed), and false if filename is not found or
cannot be read.
Digite o comando "help source" no seu shell.
Você receberá uma saída assim:
source: source filename [arguments]
Execute commands from a file in the current shell.
Read and execute commands from FILENAME in the current shell. The
entries in $PATH are used to find the directory containing FILENAME.
If any ARGUMENTS are supplied, they become the positional parameters
when FILENAME is executed.
Exit Status:
Returns the status of the last command executed in FILENAME; fails if
FILENAME cannot be read.
Do Projeto de Documentação do Linux, Guia Avançado de Script Bash,
Capítulo 15 - Comandos internos e internos :
source, . (dot command):
This command, when invoked from the command-line, executes a script. Within a script, a source file-name loads the file file-name. Sourcing a file (dot-command) imports code into the script, appending to the script (same effect as the #include directive in a C program). The net result is the same as if the "sourced" lines of code were physically present in the body of the script. This is useful in situations when multiple scripts use a common data file or function library.
If the sourced file is itself an executable script, then it will run, then return control to the script that called it. A sourced executable script may use a return for this purpose.
Assim, para os que estão familiarizados com a linguagem de programação C, o fornecimento de um arquivo tem um efeito semelhante à diretiva #include .
Note também que você pode passar argumentos posicionais para o arquivo que está sendo originado, como:
$ source $filename $arg1 arg2
Deve-se notar que, embora seja um comando incrível, nem source nem sua abreviação de . fornecerão mais de um arquivo, significando
source *.sh
ou
. script1.sh script2.sh
não funcionará.
Podemos retroceder usando for loops, mas isso executaria o executável muitas vezes, criando vários comandos ou emissão dele.
Conclusão: source não recebe vários arquivos como entrada. O argumento tem que ser um.
Que suga IMHO.
Tags bash documentation shell