что такое entry point
Точки входа в Python
Многие думают, что точки входа это такие инструкции в setup.py, которые позволяют сделать пакет доступным для запуска из командной строки. Это, в целом, верно, но возможности точек входа не ограничиваются этим.
Ниже я покажу как можно реализовать систему плагинов для пакета, чтобы другие люди могли с ним взаимодействовать или, например, расширять его функциональность динамически.
Осторожно: специфический юмор далее по тексту.
ООО «Змейка»
Поздравляю! Вас только что назначили главой ООО «Змейка». Это очень ответственная должность, ударить в грязь лицом нельзя, а значит, нужно как можно скорее дать указание отделу разработки приступить к созданию прототипа продукта. И вот, лучшие умы компании начинают работу над snek.py:
Чуть позже, на собрании акционеров вы с гордостью демонстрируете первые результаты!
Змейка как сервис
К сожалению, рядовой потребитель пока ещё не освоил Python и хочет запускать программу из консоли, не думая об интерпретаторе или местоположении snek.py. Что ж, наши лучшие специалисты на то и лучшие, что смогли запаковать скрипт так, чтобы он автоматически создавал консольную команду при установке.
Для создания распространяемого пакета нам нужен файл setup.py, где содержится информация о зависимостях, лицензии и т.д. Помимо этого, в нём можно указать точки входа:
console_scripts, как пояснили специалисты, специальная точка входа. setuptools читает её элементы как » = «, создавая для каждого элемента консольную утилиту при установке пакета.
Пока что давайте установим скрипт из исходников:
На конференции, посвящённой итогам года, вы выступаете, демонстрируя новейшую разработку:
Змейка в каждый дом
Змейка завоёвывает мир. Компания провела IPO и была оценена в рекордные 60 миллиардов долларов. Хипстеры требуют новую, стильную, модную и молодёжную змейку. А раз есть спрос, будет и предложение:
Хипстеры в восторге:
Транснациональная Змейка
Миллионы человек не мыслят свой день без змейки. Даже после поглощения Гугла ресурсов ООО «Змейка» не хватает, чтобы удовлетворять потребности пользователей по всему миру. Похоже настало время дать людям возможность создавать собственных змеек на базе нашей инфраструктуры.
Теперь, каждый раз когда snek запущена, она ищет других зарегистрированных в системе змеек, используя точку входа snek_types. Каждая такая змейка зарегистрирована под названием её типа, что позволяет выбирать нужную змейку в зависимости от параметров консоли.
Всё самое главное происходит внутри get_sneks. Вызов pkg_resources.iter_entry_points(‘snek_types’) позволяет пройтись по всем точкам входа, зарегистрированным под именем «snek_types» где-либо. Таким образом, любой сторонний пакет сможет в своём setup.py создать точку входа «snek_types», чтобы быть загруженным нашим скриптом.
Мы рассказали о «snek_types» нашим коллегам из ООО «Змеиные решения», и они тут же начали создавать змейку своей мечты. Вот каким получился их пакет cute_snek.py:
А вот как они реализовали свой setup.py, чтобы наша snek могла загрузить их змейку:
Они зарегистрировали переменную cute_snek в модуле cute_snek под именем cute. Далее они устанавливают пакеты snek и cute_snek:
Теперь, запустив snek, они могут вывести свою змейку из пакета cute_snek за счёт её динамической загрузки по точке входа:
Змейка 2.0
Пока всё внимание высшего руководства уходит на разборки с налоговой инспекцией и антимонопольной службой, отдел разработки наконец-то может выкроить немного времени на рефакторинг кода.
Главный системный архитектор понял, что если сторонние змейки могут быть загружены как плагины, значит, так же могут быть загружены и встроенные змейки.
Уберём особую обработку встроенных змеек:
И взамен зарегистрируем для них универсальные точки входа:
Переустановим изменённую змейку:
На этом всё. Теперь вы знаете, как использовать точки входа в Python!
Статья Entry Point – дело о пропавшем индексе (часть 1)
В данной статье рассмотрим несколько способов реализации фиктивных точек EntryPoint, что позволит защитить наши программы от взлома и отладки. Например зачем выставлять на показ процедуру проверки введённого пароля, или какой-нибудь авторской техники? До тех пор пока она не станет достоянием общественности, мы сможем использовать её в своих программах снова и снова. Но как-только корабль даст течь, придётся латать дыры, на что нужно время, которого всегда не хватает.
Проблема в том, что если в наших планах написать использующее системные механизмы кроссплатформенное приложение, то мы непременно столкнёмся с трудностями. Связано это с тем, что детали реализации того-же загрузчика отличаются на разных осках, хотя и исповедуют идентичные концепции. Конечно-же можно протестить все версии Win от хрюши до десятки и создать базу фундаментальных особенностей, но это не наши методы – слишком сомнительной будет репутация у такого приложения. Правильным решением будет поиск необходимых сигнатур по ходу дела в реальной обстановке, на что и сделаем ставку.
Места обитания точки-входа
Найти и хакнуть EntryPoint не проблема, гораздо трудней скрыть сам факт подмены. Такие отладчики как WinDbg, Syser, OllyDbg сейчас доступны всем и подняли с горшка не одно поколение начинающих крэкеров. Даже беглый анализ приложения может сразу выявить подвох, что сведёт на-нет все наши планы. К примеру, вот окно утилиты «DiE» для сбора информации об исполняемом файле, где как феникс из пепла восстаёт адрес EP:
На этом этапе, «горячие головы» ринулись-бы подменять EntryPoint в заголовке находящегося в памяти файла, и.. обломались-бы по полной! Здесь и начинается самое интересное..
Детали системного лоадера LDR
Дело в том, что загрузчик образов считывает значение EntryPoint из РЕ.28h только один раз, на начальном этапе своей работы, и больше к заголовку не обращается вообще. Получив точку-входа, загрузчик кидает её на самое дно стека, а завершающая работу лоадера функция ZwContinue() потом использует это значение как свой аргумент, передавая на неё управление.
Судя по рисунку, алгоритм работы загрузчиков XP и семёрки отличается. В частности на семке маячат две точки-входа, в то время-как хрюше достаточно одной.
Практика – сбор информации
И тут мы сталкиваемся с основной проблемой!
Нам нужно подменить значение в стеке задолго до того, как загрузчик закончит свою работу и передаст управление на первую инструкцию секции-кода. Другими словами, нам нужно вмешаться в работу загрузчика образов LDR. Как это сделать? На первый взгляд – миссия не выполнима, т.к. наш код ещё не получил управления. Но посмотрим на рисунок ниже..
Но если душа желает хардкора, нично не мешает осуществить перехват EP и внутри статической библиотеки. Правила оформления кода DLL требуют вполне документированной функции инициализации под названием DllEntryPoint() из Ntdll.dll (точка-входа в библиотеку). Она позволяет вызывать свои экспортируемые функции по четырём внешним факторам:
• Dll_Process_Attach – вызов функции при подключении библиотеки к процессу (наш клиент).
• Dll_Process_Detach – вызов функции экспорта при завершении родительского процесса.
• Dll_Thread_Attach – родитель создаёт новый поток (на основной поток не распространяется).
• Dll_Thread_Detach – поток отработал и завершается.
Основное ограничение тут – это запрет на вызов некоторых API, и большинство вещей приходится делать вручную. Использовать для шпионажа статически прилинкованные либы намного интересней и позволяют перехватывать различные действия системы на более раннем этапе запуска процесса на исполнение. Зато в коллбэках можно избавиться от рутины, озадачивая этим функции API. Так-что свобода выбора тут имеется.
entry point
Смотреть что такое «entry point» в других словарях:
Entry Point — [dt. »Einsprungstelle«], Sprung … Universal-Lexikon
Entry point — In computer programming, an entry point is a memory address, corresponding to a point in the code of a computer program which is intended as destination of a long jump, be it internal or external. Usage customs Contemporary In most of today s… … Wikipedia
Entry Point — The price at which an investor buys an investment. The entry point is usually a component of a predetermined trading strategy for minimizing investment risk and removing the emotion from trading decisions. Recognizing a good entry point is the… … Investment dictionary
entry point — įėjimo taškas statusas T sritis informatika apibrėžtis Vieta programoje, nuo kurios prasideda komandos, kai į ją kreipiamasi. Programa gali turėti kelis įėjimo taškus. Pavyzdžiui, kiekvienas ↑dinaminės bibliotekos modulis turi atskirą įėjimo… … Enciklopedinis kompiuterijos žodynas
entry point — i. The point at which an aircraft transits from an offshore control area to an oceanic airspace. ii. The position at which an aircraft enters a control zone … Aviation dictionary
entry point for the eye — noun The first spot in a particular print advertisement noticed by the reader. We thought the entry point for the eye in this ad would be the actress’ face, but it was actually her legs … Wiktionary
Standardized Tactical Entry Point — The primary objective of Standardized Tactical Entry Point (STEP) is to extend DISN services into the tactical theater to provide initial connectivity between the deployed warfighter and sustaining base.DISN services will include Defense Switched … Wikipedia
Multiple Entry Point Payment System — (MEPPS) A procedure that simplifies postage payment and documentation for mailings generated by computer supported mailer systems … Glossary of postal terms
customs entry point — /ˌkʌstəmz entri pɔɪnt/ noun a place at a border between two countries where goods are declared to customs … Marketing dictionary in english
customs entry point — /ˌkʌstəmz entri pɔɪnt/ noun a place at a border between two countries where goods are declared to customs … Dictionary of banking and finance
point to — ˈpoint to [transitive] [present tense I/you/we/they point to he/she/it points to present participle pointing to past tense pointed to past p … Useful english dictionary
entry point
1 entry point
точка ввода
Место в документе, в котором находится указатель курсора и в которое производится текущий ввод информации.
[ http://www.morepc.ru/dict/]
Тематики
Тематики
2 entry point
3 entry point
4 entry point
5 entry point
6 entry-point
7 entry point
8 entry point
9 entry point
10 entry point
11 entry point
12 entry point
13 entry point
14 entry point
15 entry point
16 entry point
17 entry point
18 entry point
19 entry point
20 entry point
См. также в других словарях:
Entry Point — [dt. »Einsprungstelle«], Sprung … Universal-Lexikon
Entry point — In computer programming, an entry point is a memory address, corresponding to a point in the code of a computer program which is intended as destination of a long jump, be it internal or external. Usage customs Contemporary In most of today s… … Wikipedia
Entry Point — The price at which an investor buys an investment. The entry point is usually a component of a predetermined trading strategy for minimizing investment risk and removing the emotion from trading decisions. Recognizing a good entry point is the… … Investment dictionary
entry point — įėjimo taškas statusas T sritis informatika apibrėžtis Vieta programoje, nuo kurios prasideda komandos, kai į ją kreipiamasi. Programa gali turėti kelis įėjimo taškus. Pavyzdžiui, kiekvienas ↑dinaminės bibliotekos modulis turi atskirą įėjimo… … Enciklopedinis kompiuterijos žodynas
entry point — i. The point at which an aircraft transits from an offshore control area to an oceanic airspace. ii. The position at which an aircraft enters a control zone … Aviation dictionary
entry point for the eye — noun The first spot in a particular print advertisement noticed by the reader. We thought the entry point for the eye in this ad would be the actress’ face, but it was actually her legs … Wiktionary
Standardized Tactical Entry Point — The primary objective of Standardized Tactical Entry Point (STEP) is to extend DISN services into the tactical theater to provide initial connectivity between the deployed warfighter and sustaining base.DISN services will include Defense Switched … Wikipedia
Multiple Entry Point Payment System — (MEPPS) A procedure that simplifies postage payment and documentation for mailings generated by computer supported mailer systems … Glossary of postal terms
customs entry point — /ˌkʌstəmz entri pɔɪnt/ noun a place at a border between two countries where goods are declared to customs … Marketing dictionary in english
customs entry point — /ˌkʌstəmz entri pɔɪnt/ noun a place at a border between two countries where goods are declared to customs … Dictionary of banking and finance
point to — ˈpoint to [transitive] [present tense I/you/we/they point to he/she/it points to present participle pointing to past tense pointed to past p … Useful english dictionary
ENTRYPOINT vs CMD: назад к основам
Факт 1: Требуется определить хотя бы одну инструкцию ( ENTRYPOINT или CMD ) (для запуска).
Факт 2: Если во время выполнения определена только одна из инструкций, то и CMD и ENTRYPOINT будут иметь одинаковый эффект.
Хотя этот пример и показывает, что между ENTRYPOINT и CMD нет никакой разницы, её можно увидеть, сравнив метаданные контейнеров.
Например, первый файл Dockerfile (с определенной ENTRYPOINT ):
Затем изучим процессы:
Факт 4: Режим exec является рекомендуемым.
Это связано с тем, что контейнеры задуманы так, чтобы содержать один процесс. Например, отправленные в контейнер сигналы перенаправляются процессу, запущенному внутри контейнера с идентификатором PID, равным 1. Очень познавательный опыт: чтобы проверить факт перенаправления, полезно запустить контейнер ping и попытаться нажать ctrl + c для остановки контейнера.
Контейнер, определенный с помощью режима exec, успешно завершает работу:
При использовании режима «shell» контейнер работает не так, как ожидалось.
Факт 5: Нет оболочки? Нет переменных окружения.
Факт 6: Аргументы CMD присоединяются к концу инструкции ENTRYPOINT … иногда.
Вот тут-то и начинается путаница. В руководстве есть таблица, цель которой – внести ясность в этот вопрос.
Попытаюсь объяснить на пальцах.
Строка blah blah blah blah была проигнорирована.
FACT 6b: При использовании режима exec для ENTRYPOINT аргументы CMD добавляются в конце.
Факт 7: Инструкции ENTRYPOINT и CMD могут быть переопределены с помощью флагов командной строки.
Достаточно фактов… Что же делать мне?
Это решение я собираюсь оставить на усмотрение человека, создающего Dockerfile, который может быть использован другими разработчиками.
Запуск с параметрами по умолчанию:
Переопределение CMD собственными параметрами:
Я предпочитаю по большей части этот метод, потому что он дает разработчикам свободу легко переопределять исполняемый файл оболочкой или другим исполняемым файлом.
Очистка
После запуска команд на хосте осталась куча остановленных контейнеров. Очистите их следующей командой:
Обратная связь
Джон Закконе
Капитан Докера и инженер по облачным технологиям в IBM. Специализируется на Agile, микросервисах, контейнерах, автоматизации, REST, DevOps.