gitremote-helpers - Онлайн у хмарі

ПРОГРАМА:

ІМ'Я

gitremote-helpers - Допоміжні програми для взаємодії з віддаленими репозиторіями

СИНТАКСИС

мерзотник дистанційно- [ ]

ОПИС

Віддалені допоміжні програми зазвичай не використовуються безпосередньо кінцевими користувачами, але вони викликаються
від Git, коли йому потрібно взаємодіяти з віддаленими сховищами, Git не підтримує ізначально. А
даний помічник реалізує підмножину можливостей, описаних тут. Коли потрібен Git
щоб взаємодіяти зі сховищем за допомогою віддаленого помічника, він породжує помічник як файл
незалежний процес, надсилає команди на стандартний вхід помічника та очікує результатів
зі стандартного виводу помічника. Тому що віддалений помічник працює як незалежний процес
з Git, немає потреби повторно зв’язувати Git, щоб додати нового помічника, ані пов’язувати
помічник із реалізацією Git.

Кожен помічник повинен підтримувати команду "capabilities", яку Git використовує, щоб визначити, що саме
інші команди, які буде приймати помічник. Ці інші команди можна використовувати для виявлення та
оновлювати віддалені посилання, транспортувати об'єкти між базою даних об'єктів і віддаленим
репозиторію та оновіть локальне сховище об’єктів.

Git поставляється з сімейством віддалених помічників "curl", які обробляють різні транспортні протоколи,
такий як git-remote-http, git-remote-https, git-remote-ftp та git-remote-ftps. Вони
реалізувати можливості отримувати, варіант та штовхати.

ІНВОКАЦІЯ

Віддалені допоміжні програми викликаються з одним або (необов'язково) двома аргументами. Перший
аргумент визначає віддалене сховище, як у Git; це або ім'я налаштованого
віддалений або URL. Другий аргумент визначає URL-адресу; він зазвичай має форму
://, але можливий будь-який довільний рядок. The GIT_DIR навколишнє середовище
змінна встановлюється для віддаленого помічника і може використовуватися для визначення місця зберігання
додаткові дані або з якого каталогу викликати допоміжні команди Git.

Коли Git зустрічає URL-адресу форми ://, Де це
протокол, який він не може обробляти, він автоматично викликає мерзотник дистанційно-
з повною URL-адресою як другим аргументом. Якщо така URL-адреса зустрічається безпосередньо на
командного рядка, перший аргумент такий самий, як і другий, і якщо він зустрічається в a
налаштований пульт, першим аргументом є ім’я цього пульта.

URL-адреса форми :: явно вказує Git викликати мерзотник
дистанційно- з як другий аргумент. Якщо зустрічається така URL-адреса
безпосередньо в командному рядку, перший аргумент , і якщо він зустрічається в
налаштований пульт, першим аргументом є ім’я цього пульта.

Крім того, коли налаштований пульт дистанційного керування має дистанційний. .vcs встановлений в , Git
явно викликає мерзотник дистанційно- з як перший аргумент. Якщо встановлено, то
другий аргумент дистанційний. .url; інакше другий аргумент опускається.

ВХІД ФОРМАТ

Git надсилає віддаленому помічнику список команд на стандартному введенні, по одній на рядок. Перший
команда завжди є можливості команду, у відповідь на яку повинен віддалений помічник
надрукувати список можливостей, які він підтримує (див. нижче), за яким слід порожній рядок. The
відповідь на команду capabilities визначає, які команди Git використовує в решті
командний потік.

Потік команд завершується порожнім рядком. У деяких випадках (вказано в
документації відповідних команд), за цим порожнім рядком слідує корисне навантаження в деяких
інший протокол (наприклад, протокол pack), тоді як в інших він вказує на кінець введення.

Можливості
Очікується, що кожен віддалений помічник підтримуватиме лише підмножину команд. Операції а
допоміжні підтримки оголошуються в Git у відповіді на команду capabilities (див
КОМАНДІ, нижче).

Далі ми перерахуємо всі визначені можливості та для кожної ми перерахуємо, які команди a
помічник з цією можливістю повинен надати.

Можливості та цінності Натискання
з'єднуватися
Можна спробувати підключитися до мерзотник отримати-пакет (для штовхання), мерзотник upload-pack, тощо для
спілкування за допомогою рідного протоколу packfile git. Для цього потрібен двонаправлений,
повнодуплексне підключення.

Підтримувані команди: з'єднуватися.

штовхати
Може виявляти віддалені посилання та натискати локальні коміти та історію, що веде до них
до нових або існуючих віддалених рефералів.

Підтримувані команди: список за-штовхнути, штовхати.

експорт
Може виявляти віддалені посилання та надсилати певні об’єкти з потоку швидкого імпорту до
віддалені реф.

Підтримувані команди: список за-штовхнути, експорт.

Якщо помічник рекламує з'єднуватися, Git використає його, якщо можливо, і повернеться до іншого
можливість, якщо помічник вимагає цього під час підключення (див з'єднуватися команда під
КОМАНДІ). При виборі між штовхати та експорт, Git віддає перевагу штовхати. Інші фронтенди
може мати інший порядок переваг.

без приватного оновлення
При використанні refspec можливість, git зазвичай оновлює приватну посилання
вдалий поштовх. Це оновлення вимкнено, коли віддалений помічник оголошує
можливості без приватного оновлення.

Можливості та цінності Витяг
з'єднуватися
Можна спробувати підключитися до мерзотник upload-pack (для отримання), мерзотник отримати-пакет, тощо для
спілкування за допомогою рідного протоколу packfile Git. Для цього потрібно a
двонаправлене, повнодуплексне з'єднання.

Підтримувані команди: з'єднуватися.

отримувати
Може виявляти віддалені посилання та передавати об’єкти, доступні від них, до локальних
магазин предметів.

Підтримувані команди: список, отримувати.

імпорт
Може виявляти віддалені посилання та виводити об’єкти, доступні з них як потік
формат швидкого імпорту.

Підтримувані команди: список, імпорт.

перевірити підключення
Може гарантувати, що, коли запитується клон, отриманий пакет буде автономним
і підключений.

Якщо помічник рекламує з'єднуватися, Git використає його, якщо можливо, і повернеться до іншого
можливість, якщо помічник вимагає цього під час підключення (див з'єднуватися команда під
КОМАНДІ). При виборі між отримувати та імпорт, Git віддає перевагу отримувати. Інші фронтенди
може мати інший порядок переваг.

Різне можливості
варіант
Для визначення параметрів, таких як багатослівність (скільки виводу записувати в stderr) і
глибина (скільки потрібна історія у випадку неглибокого клону), яка впливає на те, як
виконуються інші команди.

refspec
Для віддалених помічників, які реалізують імпорт or експорт, ця можливість дозволяє
refs потрібно обмежувати приватним простором імен, замість запису в refs/heads або
refs/remotes безпосередньо. Рекомендується всім імпортерам, які надають імпорт
можливість використовувати це. Це обов’язково для експорт.

Помічник, який рекламує можливість refspec
refs/heads/*:refs/svn/origin/branches/* каже, що, коли його просять імпортувати
refs/heads/topic, потік, який він виводить, оновить
refs/svn/origin/branches/topic ref.

Цю можливість можна рекламувати кілька разів. Перший застосовний refspec
має пріоритет. Ліва частина refspecs, рекламована з цією можливістю, повинна
охоплює всі посилання, які повідомляє команда list. Якщо ні refspec здатність є
рекламується, є неявна специфікація *:*.

При написанні дистанційних помічників для децентралізованих систем контролю версій це так
радимо зберігати локальну копію репозиторію для взаємодії та дозволяти
приватний простір імен refs вказує на це локальне сховище, тоді як refs/remotes
простір імен використовується для відстеження віддаленого сховища.

біді-імпорт
Це змінює імпорт здатність. Команди швидкого імпорту кішка-крапля та ls може
використовуватися віддаленими помічниками для отримання інформації про краплі та дерева, які
вже існує в пам'яті швидкого імпорту. Для цього потрібен канал від швидкого імпорту до
дистанційний помічник. Якщо він рекламується на додаток до "імпорту", Git встановлює a
pipe від швидкого імпорту до stdin віддаленого помічника. Звідси випливає, що Git і
fast-import обидва підключені до stdin віддаленого помічника. Тому що Git може надсилати
кількома командами для віддаленого помічника потрібні помічники, які використовують
біді-імпорт буферувати все імпорт команди пакету перед відправкою даних до
швидкий імпорт. Це робиться для запобігання змішування команд і швидкого імпорту відповідей на файлі
стандартний номер помічника.

експортні марки
Це змінює експорт можливість, доручаючи Git скинути внутрішні позначки
стіл до після завершення. Щоб дізнатися більше, читайте далі --export-marks= in
git-fast-export(1).

імпортні знаки
Це змінює експорт можливість, вказуючи Git завантажити вказані позначки
в перед обробкою будь-якого введення. Щоб дізнатися більше, читайте далі
--import-marks= in git-fast-export(1).

підписані теги
Це змінює експорт можливість, вказуючи Git передати
--signed-tags=дослівно до git-fast-export(1). За відсутності цієї можливості,
Git буде використовувати --signed-tags=warn-strip.

КОМАНДИ

Команди надаються тим, хто викликає, на стандартному вводі помічника, по одній на рядок.

можливості
Перелічує можливості помічника, по одній на рядок, що закінчується порожнім рядком. Кожен
спроможності може передувати *, що позначає їх обов’язковими для використання версій Git
віддаленого помічника, щоб зрозуміти. Будь-яка невідома обов’язкова можливість є фатальною помилкою.

Підтримка цієї команди є обов’язковою.

список
Перелічує посилання, по одному на рядок, у форматі " [ ...]". Значення
може бути шістнадцятковий хеш sha1, "@ " для symref, або "?", щоб вказати, що помічник
не вдалося отримати значення ref. Відокремлений пробілами список атрибутів йде після
ім'я; нерозпізнані атрибути ігноруються. Список закінчується порожнім рядком.

Перелік атрибутів, визначених на даний момент, див.

Підтримується, якщо помічник має можливість "вибрати" або "імпортувати".

список за-штовхнути
Як і в список, за винятком того, що він використовується тоді й тільки тоді, коли абонент бажає
отриманий список посилань для підготовки команд push. Помічник, який підтримує як push, так і fetch
можна використовувати це, щоб розрізнити, для якої операції виводиться вихід список буде
використовуються, можливо, зменшуючи обсяг роботи, яку необхідно виконати.

Підтримується, якщо помічник має можливість "push" або "export".

варіант
Встановлює параметр транспортного помічника до . Виводить один рядок, що містить
один з ok (опція успішно встановлена), не підтримується (опція не розпізнається) або помилка
(варіант підтримується, але для нього не дійсний). Варіанти повинні бути
встановлюється перед іншими командами і може впливати на поведінку цих команд.

Перегляньте параметри, щоб переглянути список поточних параметрів.

Підтримується, якщо помічник має можливість "опціон".

отримувати
Вибирає заданий об’єкт, записуючи необхідні об’єкти в базу даних. Отримати
команди надсилаються пакетом, по одній на рядок, завершуються порожнім рядком. Виходи а
один порожній рядок, коли всі команди отримання в одному пакеті завершені. Тільки предмети
про які повідомлялося у виході список з sha1 можна отримати таким чином.

За бажанням може вивести a замикати рядок, що вказує файл у GIT_DIR/objects/pack
який зберігає пакет, доки референси не будуть належним чином оновлені.

Якщо варіант перевірити підключення запитується, помічник повинен вивести підключення-ок if
клон є автономним і пов'язаним.

Підтримується, якщо помічник має можливість «витягнути».

штовхати + :
Натискає заданий локальний фіксація або розгалуження до віддаленої гілки, описаної в .
Пакетна послідовність з одного або кількох штовхати команди завершується порожнім рядком (якщо
є лише одне посилання на push, єдине штовхати після команди стоїть пробіл
лінія). Наприклад, нижче буде дві партії штовхати, перший запитуючи
remote-helper, щоб натиснути локальну реф майстер до дистанційного ref майстер і місцевий ГОЛОВА
до віддаленого філія, а другий просить натиснути ref Foo до реф бар (примусове оновлення
на прохання +).

push refs/heads/master:refs/heads/master
push HEAD:refs/heads/branch
\n
натисніть +refs/heads/foo:refs/heads/bar
\n

Після останнього можна ввести нуль або більше параметрів протоколу штовхати команда, перед
кінцевий порожній рядок пакета.

Коли натискання завершено, виводить один або кілька ok or помилка ? ліній
щоб вказати успіх або невдачу кожного натиснутого реф. Вихід звіту про стан є
закінчується порожнім рядком. Поле параметрів може бути в лапках у рядку стилю C
якщо він містить НЧ.

Підтримується, якщо помічник має можливість "push".

імпорт
Створює потік швидкого імпорту, який імпортує поточне значення іменованого посилання. Це може
додатково імпортуйте інші посилання, якщо це необхідно для ефективної побудови історії. The
скрипт записує в спеціальний приватний простір імен помічника. Значення названого реф
має бути записано в розташування в цьому просторі імен, отримане шляхом застосування refspecs
від можливості "refspec" до імені ref.

Особливо корисно для взаємодії з іноземною системою версій.

Так само, як штовхати, пакетна послідовність з одного або кількох імпорт завершується пробілом
лінія. Для кожної партії імпорт, віддалений помічник повинен створити потік швидкого імпорту
припинено а зроблений команда

Зауважте, що якщо біді-імпорт використовується повна послідовність пакетів
буферизується перед початком надсилання даних для швидкого імпорту, щоб запобігти змішенню команд і
швидкий імпорт відповідей на стандартний номер помічника.

Підтримується, якщо помічник має можливість «імпорту».

експорт
Інструктує віддаленого помічника, що будь-який наступний вхід є частиною потоку швидкого імпорту
(згенеровано мерзотник швидкий експорт), що містить об'єкти, які слід відсунути до
віддалений.

Особливо корисно для взаємодії з іноземною системою версій.

Команда експортні марки та імпортні знаки можливості, якщо вони вказані, впливають на цю команду в
наскільки вони передаються мерзотник швидкий експорт, який потім завантажить/збереже таблицю
знаки для місцевих об'єктів. Це можна використовувати для реалізації інкрементальних операцій.

Підтримується, якщо помічник має можливість «експорту».

з'єднуватися
Підключається до даної служби. Стандартний вхід і стандартний вихід хелпера підключені
до вказаної служби (префікс git включено в назву служби, тому, наприклад, отримання використовує
git-upload-pack як послуга) на віддаленій стороні. Дійсні відповіді на цю команду пусті
лінія (з'єднання встановлено), відступати (немає розумної підтримки транспортування, поверніться до німого
transports) і просто вийти з надрукованим повідомленням про помилку (не вдається підключитися, не турбуйтеся
намагаючись відступити). Після завершення переведення рядка позитивної (порожньої) відповіді
починається вихід послуги. Після завершення з’єднання віддалений помічник завершує роботу.

Підтримується, якщо помічник має можливість "підключення".

Якщо виникає фатальна помилка, програма записує повідомлення про помилку в stderr і завершує роботу. The
абонент повинен очікувати, що відповідне повідомлення про помилку було надруковано, якщо дитина закривається
підключення без завершення дійсної відповіді для поточної команди.

Можуть підтримуватися додаткові команди, що може бути визначено з можливостей, про які повідомляється
помічник.

REF СПИСОК АТРИБУТИ

Команда список Команда створює список посилань, у якому за кожним посиланням може слідувати список
атрибути. Визначено наступні атрибути списку посилань.

без змін
Це посилання не змінилося з моменту останнього імпорту або отримання, хоча помічник не може
обов'язково визначити, яку цінність це створило.

ВАРІАНТИ

Наступні параметри визначаються та (за відповідних обставин) встановлюються Git, якщо
віддалений помічник має варіант здібності

варіант багатослівність
Змінює детальність повідомлень, які відображається помічником. Значення 0 для засоби
що процеси працюють тихо, а помічник видає лише помилку. 1 є
рівень детальності за замовчуванням і вищі значення відповідають числу -в
прапори, передані в командному рядку.

варіант прогрес {правда|false}
Вмикає (або вимикає) повідомлення про прогрес, що відображаються транспортним помічником під час a
команда

варіант глибина
Поглиблює історію неглибокого сховища.

варіант теги слідування {правда|false}
Якщо ввімкнено, помічник повинен автоматично отримувати анотовані об’єкти тегу, якщо об’єкт
точки тегу в були передані під час команди вибірки. Якщо тег не отримано
помічник зазвичай надсилає другу команду вибірки, щоб запитати тег
конкретно. Деякі помічники можуть використовувати цю опцію, щоб уникнути другої мережі
підключення.

варіант сухий хід {правда|false}: Якщо вірно, уявіть, що операція виконана успішно, але
фактично не змінюйте жодних даних сховища. Для більшості помічників це стосується лише штовхати,
якщо підтримується.

варіант servpath
Встановлює шлях служби (--upload-pack, --receive-pack тощо) для наступного підключення. Віддалений помічник
може підтримувати цю опцію, але не покладатися на те, що цей параметр буде встановлено перед підключенням
запит виникає.

варіант перевірити підключення {правда|false}
Попросіть помічника перевірити підключення клону.

варіант змусити {правда|false}
Попросіть помічника виконати примусове оновлення. За замовчуванням false.

варіант клонування {'правда|false}
Повідомте помічника, що це запит на клонування (тобто поточний репозиторій гарантується
порожній).

варіант оновлення-неглибоко {'правда|false}
Дозволити розширити .git/shallow, якщо цього потребують нові посилання.

варіант pushcert {'правда|false}
GPG знак штовхає.

Використовуйте gitremote-helper онлайн за допомогою служб onworks.net