Что делает «источник»?

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

Он существует и работает. Почему в Ubuntu нет документации по этому поводу? Что оно делает? Как я могу установить документацию об этом?

Андреа Амбу
источник
5
по теме: superuser.com/questions/176783/…
lesmana
54
ты забыл $ type source source is a shell built-in
bnjmn
2
Моя оболочка вернула это $ whatis source source (1) - bash built-in commands, see bash(1). Кроме того, man sourceберет меня к BASH_BUILTINS(1)страницам руководства . Это на Fedora, кстати, не знаю, почему эти пакеты Debian не (или плохо) не документированы.
arielnmz
4
@lesmana, отличная ссылка. Этот связанный ответ является более полным ответом на этот вопрос.
Скотт
5
Попробуйте "источник помощи"
Jasser

Ответы:

469

sourceявляется встроенной командой оболочки bash, которая выполняет содержимое файла, переданного в качестве аргумента, в текущей оболочке . У него есть синоним в .(точка).

Синтаксис

. filename [arguments]

source filename [arguments]
Нагул
источник
8
Это sourceспецифическая команда bash или она есть в других оболочках? (Я прошу получить метки прямо на вопрос ...)
Джоник
2
Афайк, sourceприсутствовал в оболочке Борна и, следовательно, вероятно, присутствовал во всех его потомках. en.wikipedia.org/wiki/Bourne_shell . Я знаю, что не у всех оболочек есть sourceкоманда, менее уверенная в том, какие оболочки содержат ее.
Нагуль
13
@nagul, sourceне присутствовал в оболочке Bourne, это расширение GNU, появившееся значительно позже. Оригинальный и по- прежнему портативный синтаксис (POSIX), чтобы использовать команду «точка», то есть .вместо этого. Я лично никогда не пользуюсь, sourceучитывая тот факт, что он дольше печатается и не имеет дополнительной ценности. Я предполагаю, что его основная цель - сделать скрипты более читабельными для новичков.
Jlliagre
18
@jlliagre мое личное «объяснить, почему есть источник» заключается в том, что sourceэто не только более наглядно , но и похоже на нечто иное, чем опечатка. У меня были люди, пропускающие точку / точку, когда я посылаю технические команды по электронной почте.
Богатая Гомолка
3
Одним из распространенных применений этой команды является сценарий оболочки, который находится sourceв «файле конфигурации», который содержит в основном назначения переменных. Переменные присваивания управляют тем, что делает остальная часть скрипта. Конечно, хороший скрипт установит переменные в разумные значения по умолчанию перед sourceили, по крайней мере, проверит допустимые значения.
LawrenceC
276

Быть осторожен! ./и sourceэто не совсем то же самое .

  • ./scriptзапускает скрипт как исполняемый файл, запускает новую оболочку для его запуска
  • source scriptчитает и выполняет команды из имени файла в текущей среде оболочки

Примечание: ./scriptнет . script, но . script==source script

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

damphat
источник
27
Вы смешиваете ./command и. скрипт. команда-источник такая же, как.-команда. Использование ./meh говорит запустить скрипт / бинарный с именем meh в текущем каталоге, и не имеет никакого отношения к источнику /. -command. Как поясняется в ответе по вашей ссылке.
Йоаким Элофссон
2
@JoakimElofsson Это упомянуто в ссылке, но я изменю ответ, чтобы избежать неправильного понимания. Пожалуйста, исправьте это.
дампхат
3
Это довольно важно, что принятый ответ также указывает на этот, потому что на мгновение я подумал, что./ == source == .
Даниэль Ф
90

Полезно знать команду type:

> type source
source is a shell builtin

когда что-то встроено в оболочку, это время делать man bash.

micans
источник
1
Всегда man
19
Вы также можете использовать help {builtin-name}, то есть help source.
LawrenceC
1
helpне работает везде (по крайней мере, в Zsh). typeделает.
kumarharsh
4
Для усиления: если вы используете bash, и если вы знаете (возможно, через 'type'), что это встроенная команда, то 'help' приведет вас прямо к нужному абзацу документации, не пробираясь через 4 184 строки ' Человек Баш 'текст.
Рон Берк
38

, (точка) - это встроенная команда оболочки bash, которая выполняет команды из файла, переданного в качестве аргумента в текущей оболочке. «источник» является синонимом «.».

Со страницы руководства 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
источник
27

'source' - это длинная версия '.' команда. В командной строке bash можно сделать:

source ~/.bashrc

перезагрузить вашу (измененную?) настройку bash для текущего запущенного bash.

Короткая версия будет:

. ~/.bashrc

Страница man:

. 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. 
Йоаким Элофссон
источник
Это должен быть принятый ответ.
Питер Мортенсен
25

sourceКоманда выполняет предоставленный сценарий (разрешение на выполнение не является обязательным ) в текущей среде оболочки, а запускает./ предоставленный исполняемый сценарий в новой оболочке.

sourceУ команды есть синоним . filename.

Чтобы сделать это более понятным, взгляните на следующий скрипт, который устанавливает псевдоним.

make_alias

#! /bin/bash

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

Теперь у нас есть два варианта выполнения этого скрипта. Но только с одной опцией желаемый псевдоним для текущей оболочки может быть создан среди этих двух опций.

Опция 1: ./make_alias

Сначала сделайте скрипт исполняемым.

chmod +x make_alias

казнить

./make_alias

проверить

alias

Выход

**nothing**

Упс! Псевдоним ушел с новой оболочкой.

Пойдем со вторым вариантом.

Вариант 2: source make_alias

казнить

source make_alias

или же

. make_alias

проверить

alias

Выход

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

Да, Псевдоним установлен.

Суровая Вахария
источник
10

Если вы сомневаетесь, лучше всего использовать 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.
Акшай Упадхьяя
источник
Не могли бы вы предоставить больше, чем просто RTFM?
Питер Мортенсен
5

Введите команду «источник помощи» в вашей оболочке.

Вы получите вывод, как это:

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
источник
4

Из Проекта документации Linux, Расширенное руководство по написанию сценариев Bash,
Глава 15 - Внутренние команды и встроенные функции :

источник , . (точка команды):
эта команда при вызове из командной строки выполняет сценарий. Внутри скрипта исходное имя файла загружает имя файла. Извлечение файла (точка-команда) импортирует код в скрипт, добавляя его в скрипт (тот же эффект, что и директива #include в программе на Си). Чистый результат такой же, как если бы в теле скрипта физически присутствовали «исходные» строки кода. Это полезно в ситуациях, когда несколько сценариев используют общий файл данных или библиотеку функций.
Если исходный файл сам по себе является исполняемым скриптом, он запустится, а затем вернет управление скрипту, который его вызвал. Исходный исполняемый скрипт может использовать возврат для этой цели.

Таким образом, для тех, кто знаком с языком программирования C, поиск файла имеет эффект, аналогичный #includeдирективе.

Также обратите внимание, что вы можете передавать позиционные аргументы в файл, например:

$ source $filename $arg1 arg2
Александро де Оливейра
источник
Чем этот ответ отличается от 9 предыдущих ответов?
Стивен Раух
2
Я добавляю другой источник информации и дополнительную информацию, не упомянутую ранее.
Александро де Оливейра
Я не знал, что sourceможет принять аргументы или использовать return.
Джо
2

Следует отметить , что хотя и являются удивительной команда, ни , sourceни его сокращенным из .будет источник более одного файла, значение

source *.sh

или же

. script1.sh script2.sh

не будет работать

Мы можем прибегнуть к использованию forциклов, но он будет многократно запускать исполняемый файл, создавая несколько команд или выпуская его.

Вывод: sourceне принимает несколько файлов в качестве входных данных. Аргумент должен быть один.

Который ИМХО отстой.

Питер Мортенсен
источник
0

С помощью source вы можете передавать переменные или функции из другого файла в ваш скрипт и использовать их без необходимости их повторной записи.

FI:

#!/bin/bash

source /etc/environment

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

ура

DimiDak
источник