¿Qué hace 'fuente'?

583
$ whatis source
source: nothing appropriate.
$ man source
No manual entry for source
$ source
bash: source: filename argument required
source: usage: source filename [arguments]

Existe y es ejecutable. ¿Por qué no hay documentación al respecto en Ubuntu? ¿Qué hace? ¿Cómo puedo instalar documentación al respecto?

Andrea Ambu
fuente
55
relacionados: superuser.com/questions/176783/...
Lesmana
54
te olvidaste $ type source source is a shell built-in
bnjmn
2
Mi caparazón me devolvió esto $ whatis source source (1) - bash built-in commands, see bash(1). Además, man sourceme lleva a las BASH_BUILTINS(1)páginas del manual. Esto está en Fedora por cierto, no tengo idea de por qué esos paquetes de Debian no están (o están mal) documentados.
arielnmz
44
@lesmana, excelente enlace. Esa respuesta vinculada es la respuesta más completa a esta pregunta.
Scott
55
Prueba con "fuente de ayuda"
Jasser

Respuestas:

469

sourcees un comando incorporado de bash shell que ejecuta el contenido del archivo pasado como argumento, en el shell actual . Tiene un sinónimo en .(punto).

Sintaxis

. filename [arguments]

source filename [arguments]
nagul
fuente
8
¿Es sourceun comando específico de bash o también lo tienen otros shells? (Estoy pidiendo que las etiquetas sean correctas en la pregunta ...)
Jonik
2
Afaik, sourceestuvo presente en el caparazón de Bourne y, por lo tanto, probablemente presente en todos sus descendientes. en.wikipedia.org/wiki/Bourne_shell . Sé que no todos los shells tienen el sourcecomando, menos seguro de qué shells lo contienen.
nagul
13
@nagul, sourceno estaba presente en el shell Bourne, es una extensión de GNU que llegó mucho más tarde. La sintaxis original y aún portátil (POSIX) es utilizar el comando "punto", es decir, en su .lugar. Personalmente, nunca uso sourcedado que es más largo para escribir y no tiene valor agregado. Supongo que su propósito principal es hacer que los scripts sean más legibles para los novatos.
jlliagre
18
@jlliagre mi "explicación de por qué tener fuente" personal es que sourceno solo es más descriptivo, sino que parece algo más que un error tipográfico. He tenido personas que omiten el punto / punto cuando envío comandos técnicos por correo electrónico.
Rich Homolka
3
Un uso común de este comando es para un script de shell sourceen un "archivo de configuración" que contiene principalmente asignaciones variables. Las asignaciones variables luego controlan las cosas que hace el resto del script. Por supuesto, un buen script establecerá las variables en valores predeterminados sensibles antes de source, o al menos buscará valores válidos.
LawrenceC
276

¡Ten cuidado! ./y nosource son exactamente lo mismo .

  • ./scriptejecuta el script como un archivo ejecutable, inicia un nuevo shell para ejecutarlo
  • source scriptlee y ejecuta comandos del nombre del archivo en el entorno actual del shell

Nota: ./scriptno lo es . script, pero . script==source script

https://askubuntu.com/questions/182012/is-there-a-difference-between-and-source-in-bash-after-all?lq=1

Damphat
fuente
27
Estás mezclando ./command y. guión. el comando fuente es el mismo que el comando. Usar ./meh dice ejecutar script / binary llamado meh en el directorio actual, y no tiene nada que ver con source /. -mando. Como se explica en la respuesta en su enlace.
Joakim Elofsson
2
@JoakimElofsson Se menciona en el enlace, pero modificaré la respuesta para evitar malentendidos. Por favor corríjalo.
húmedo el
3
Es algo importante que la respuesta aceptada también señale a esta, porque por un momento pensé que./ == source == .
Daniel F
90

Es útil conocer el comando 'tipo':

> type source
source is a shell builtin

cada vez que algo es un caparazón incorporado, es hora de hacerlo man bash.

micanos
fuente
1
Siempre sepa algo nuevo cuando lea man)
19
También puede usar help {builtin-name}, es decir help source.
LawrenceC
1
helpno funciona en todas partes (al menos en zsh). typehace.
kumarharsh
44
Para amplificar: si está usando bash, y si sabe (tal vez a través de 'tipo') que es un comando incorporado, entonces 'ayuda' lo llevará directamente al párrafo de documentación que desea sin pasar por 4.184 líneas de ' hombre bash 'texto.
Ron Burk
38

. (un punto) es un comando incorporado de bash shell que ejecuta los comandos de un archivo pasado como argumento, en el shell actual. 'fuente' es sinónimo de '.'.

Desde la página de manual de 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.
Jawa
fuente
27

'fuente' es la versión larga de '.' mando. En el indicador bash se puede hacer:

source ~/.bashrc

para recargar su configuración de bash (¿cambiado?) para bash actual en ejecución.

La versión corta sería:

. ~/.bashrc

La página del 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 shopt
    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. 
Joakim Elofsson
fuente
Esta debería ser la respuesta aceptada.
Peter Mortensen
25

sourceEl comando ejecuta el script proporcionado (el permiso ejecutable no es obligatorio ) en el entorno actual del shell, mientras que ./ejecuta el script ejecutable proporcionado en un nuevo shell.

sourcecomando tiene un sinónimo . filename.

Para que quede más claro, eche un vistazo al siguiente script, que establece el alias.

make_alias

#! /bin/bash

alias myproject='cd ~/Documents/Projects/2015/NewProject'

Ahora tenemos dos opciones para ejecutar este script. Pero con solo una opción, el alias deseado para el shell actual se puede crear entre estas dos opciones.

Opción 1: ./make_alias

Haga el script ejecutable primero.

chmod +x make_alias

Ejecutar

./make_alias

Verificar

alias

Salida

**nothing**

Whoops! Alias ​​se ha ido con el nuevo caparazón.

Vayamos con la segunda opción.

Opcion 2: source make_alias

Ejecutar

source make_alias

o

. make_alias

Verificar

alias

Salida

alias myproject='cd ~/Documents/Projects/2015/NewProject'

Sí, Alias ​​está listo.

Vakharia dura
fuente
10

En caso de duda, lo mejor es usar el infocomando:

[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.
Akshay Upadhyaya
fuente
¿Podría proporcionar algo más que RTFM?
Peter Mortensen
5

Escriba el comando "fuente de ayuda" en su shell.

Obtendrá una salida como esta:

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.
Jasser
fuente
4

Del Proyecto de documentación de Linux, Advanced Bash Scripting Guide,
Capítulo 15 - Comandos internos y Builtins :

fuente , . (comando de punto):
este comando, cuando se invoca desde la línea de comandos, ejecuta un script. Dentro de un script, un nombre de archivo fuente carga el nombre de archivo del archivo. El aprovisionamiento de un archivo (comando de puntos) importa código en el script, anexándolo al script (el mismo efecto que la directiva #include en un programa en C). El resultado neto es el mismo que si las líneas de código "de origen" estuvieran físicamente presentes en el cuerpo del script. Esto es útil en situaciones en las que varios scripts usan un archivo de datos común o una biblioteca de funciones.
Si el archivo de origen es un script ejecutable, se ejecutará y luego devolverá el control al script que lo llamó. Un script ejecutable de origen puede usar una devolución para este propósito.

Entonces, para aquellos familiarizados con el lenguaje de programación C, el abastecimiento de un archivo tiene un efecto similar al de la #includedirectiva.

Tenga en cuenta también que puede pasar argumentos posicionales al archivo de origen, como:

$ source $filename $arg1 arg2
Alexandro de Oliveira
fuente
¿Cómo difiere esta respuesta de las 9 respuestas anteriores?
Stephen Rauch
2
Agrego otra fuente de información e información adicional no mencionada anteriormente.
Alexandro de Oliveira
No sabía que eso sourcepodría llevar argumentos o uso return.
Joe
2

Cabe señalar que a pesar de ser un comando impresionante, ni sourcetampoco su forma abreviada de .que la fuente de más de un archivo, significado

source *.sh

o

. script1.sh script2.sh

será no trabajar.

Podemos retroceder usando forbucles, pero emitiría el ejecutable muchas veces, creando múltiples comandos o emitiéndolo.

Conclusión: sourceno toma múltiples archivos como entrada. El argumento tiene que ser uno.

Lo que apesta en mi humilde opinión.

Peter Mortensen
fuente
0

Con la fuente, puede pasar variables o funciones de otro archivo a su script y usarlas sin tener que volver a escribirlas.

FI:

#!/bin/bash

source /etc/environment

source /myscripts/jetty-common/config/jetty-functions.sh

Salud

DimiDak
fuente