Приложение A. Параметры командной строки системы Turbo Profiler

Формат командной строки, используемый при запуске системы Turbo Profiler имеет следующий вид:

TPROF [<параметры командной строки>][<имя программы>[<аргументы программы>]],

где <параметры командной строки> — это список, состоящий из одного или более параметров командной строки профилировщика (см. Таблицу А.1), <имя программы> — это имя программы, профиль которой Вы хотите получить, <аргументы программы> — это список, состоящий из одного или более аргументов командной строки профилируемой программы.

Вы можете набрать на клавиатуре только лишь TPROF, не указывая ни параметров, ни имени программы. В этом случае Вам потребуется с помощью команд среды системы Turbo Profiler загрузить Вашу программу в эту среду.

Вот некоторые примеры командных строк, запускающих систему Turbo Profiler:

tprof — sc prog1 a b …………….. Данная команда производит запуск профилировщика с параметром — sc и загружает программу PROG1 с двумя аргументами командной строки а и в.

tprof prog2 —x……………………Эта команда запускает профилировщик со значениями параметров, задаваемыми по умолчанию и загружает программу Prog2 с одним аргументом — х.

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

Все параметры командной строки системы Turbo Profiler начинаются с символа дефиса (-). По крайней мере один пробел или символ табуляции должен отделять каждый из параметров друг от друга и от команды TPROF.

Для того, чтобы использовать параметр командной строки для отключения соответствующего свойства, необходимо ввести символ дефиса после указания соответствующего параметра. Например, при помощи строки вида — vg— отключается действие параметра, сохраняющего графику. Обычно Вам приходится отключать действие какого-либо параметра в том случае, если данный параметр постоянно установлен в файле конфигурации профилировщика, TFCONFIG.TF. (Вы можете модифицировать файл конфигурации при помощи инсталляционной программы TFINST, описанной во введении к данному руководству).

В таблице А.1 дана сводка параметров командной строки системы Turbo Profiler, более подробное описание этих параметров содержится на последующих страницах.

Таблица А.1 Параметры командной строки системы Turbo Profiler.

Параметр…………………………..Действие параметра

— clife………………………………Загружает файл конфигурации.

— do………………………………..Выполняет профилировщик на втором дисплее.

— dp………………………………..Изображает среду профилировщика на одной дисплейной странице, а данные, выводимые профилируемой программой, на другой странице.

— ds………………………………..Поддерживает отдельные образы экранов для профилировщика и профилируемой программы.

— h…………………………………Изображает экран помощи.

— ?………………………………….Так же изображает экран помощи

— i…………………………………..Позволяет переключаться между процессом и ID

— mN………………………………..Устанавливает размер динамической области памяти ("кучи"), равным N килобайтам.

— р…………………………………..Включает поддержку мыши.

— r…………………………………..Включает удаленное профилирование через последовательный порт.

— rpN………………………………..Устанавливает номер порта N, через который осуществляется удаленная связь.

— rsN………………………………..Устанавливает скорость обмена при удаленной связи.

— sc…………………………………Приводит к тому, что при вводе имен символов не учитывается регистр (верхний или нижний) в котором набираются эти имена.

— sd…………………………………Устанавливает одну или более директорий для поиска файлов с исходными текстами.

— vd…………………………………Сохраняет полный графический образ экрана программы.

— vn…………………………………Отключает 43/50-строчный режим работы дисплея.

— vp…………………………………Включает сохранение палитры. EGA для экрана вывода программы.

— yN………………………………….Задает размер области памяти, в которой размещаются оверлеи, равным N килобайтам.

— yeN………………………………..Задает размер области в памяти EMS, предназначенной для оверлеев, равным N страницам по 16К каждая.

Файл конфигурации (-с)

Этот параметр указывает системе Turbo Profiler на то, что необходимо загрузить файл конфигурации. По умолчанию именем этого файла считается TFCONFIG.TF. Если Вы захотите загрузить какой-либо другой файл, Вы должны указать имя этого файла сразу же вслед за строкой — с, между именем файла и названием параметра не должно быть пробелов.

Способ изображения (-d)

Все параметры, начинающиеся с — d, задают способ изображения данных, используемый профилировщиком.

— do

Исполняет профилировщик на втором дисплее. Вы может одновременно наблюдать экран Вашей программы на одном дисплее, а систему Тurbo Profiler на втором дисплее.

— dp

Это параметр, задаваемый по умолчанию для цветных дисплеев.

При задании этого параметра, среда профилировщика изображается на одной дисплейной странице, а вывод профилируемой программы на другой. Использование двух дисплейных страниц минимизирует время, требующееся для переключения между двумя экранами. Этот параметр Вы можете использовать только при работе с цветным дисплеем, так только у цветного дисплея имеется несколько страниц видеопамяти. Вы не сможете воспользоваться этим параметром в случае, если профилируемая программа использует множество страниц видеопамяти.

— ds

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

При каждом запуске программы или обращении к профилировщику, Turbo Profiler считывает из памяти соответствующий экран. Этот метод поддержки двух образов экранов является самым медленным, но он применим к любому типу дисплея и работает с программами, использующими для видеодоступа необычные средства.

Помощь (-h и —?)

Оба этих параметра приводят к изображению синтаксиса командной строки для запуска системы Turbo Profiler, а также списка параметров.

Рис. А.1 Помощь, предоставляемая на уровне DOS системой Turbo Profiler

Переключение между процессом и ID(-i)

Используйте этот параметр для активации возможности переключения между процессом и ID.

Модификация размера динамически распределяемой области памяти (-m)

Этот параметр задает размер динамически распределяемой области памяти ("кучи") равным N килобайтам, синтаксис этого параметра имеет вид:

— mN

По умолчанию размер "кучи" задается равным 40К, наибольшее допустимое значение — это 64К. Если Ваша программа для своего выполнения требует большого количества памяти, то при помощи этого параметра Вы можете уменьшить размер "кучи", используемой системой Turbo Profiler. Также при помощи этого параметра Вы можете увеличить размер "кучи", во время получения профилей программ, занимающих мало места в памяти. Этот параметр позволяет системе Turbo Profiler временно хранить в верхних адресах кучи некоторую дополнительную информацию, такую как, например, список команд, вызванных пользователей в ходе сеанса профилирования.

Если TPROF исчерпывает доступную ему память, Вы получаете сообщение об ошибке в случае попытки открыть какое-либо окно и выполнить какую-нибудь другую операцию, требующую большого количества памяти. Также некоторые статистические данные, такие как, например, данные о вызывающих подпрограммах, в этом случае могут быть частично утрачены.

Поддержка мыши (-р)

Этот параметр включает поддержку мыши.

Удаленное профилирование (-r)

Все параметры, начинающиеся с — r регулируют характеристики удаленного профилирования

— r

Включает возможность профилирования на удаленной системе через последовательный порт. По умолчанию используется последовательный порт СОМ1 и скорость передачи данных 115 Кбод. (Эти значения можно изменить при помощи TFINST)

— rp

Устанавливает номер N порта, используемого для удаленного профилирования. Значение N=1 соответствует порту СОМ1, а N=2 порту СОМ2.

— rsn

Устанавливает скорость передачи данных при удаленном профилировании в соответствии со значением N:

N Скорость

1 9600 Кбод

2 40 Кбод

3 115 Кбод

Исходный текст и символические имена (-s)

Все параметры, начинающиеся с — s влияют на то, как система Turbo Profiler работает с исходным текстом программы и символическими именами.

— sc

Приводит к тому, что при вводе символических имен не учитывается, в верхнем или нижнем регистре клавиатуры они набираются, даже в том случае, когда программа была скомпонована с учетом регистра набора имен.

Если параметр — sc отсутствует, то система Turbo Profiler игнорирует регистр набора символов только в том случае, если Вы скомпоновали Вашу программу без учета регистра набора символов.

Замечание: Параметр — sc не работает в случае получения профилей программ, написанных на Паскале. Turbo Pascal не чувствителен к тому, в каком регистре клавиатуры набираются имена.

— sd

Задает одну или несколько директорий для поиска исходных текстов. Синтаксис параметра имеет вид:

— sd <имя директории>

<имя директории> может быть как относительным, так и абсолютным путем и может включать в себя буквы, обозначающие дисководы. При задании нескольких директорий, для каждой из них используется отдельный параметр — sd. (При помощи одного параметра — sd Вы можете задать только одну директорию). Система Turbo Profiler будет просматривать директории в том порядке, в котором они указаны.

Примечание: Между параметром — sd и элементом <имя директории> пробела быть не должно.

Если в файле конфигурации тоже задан список директорий, то профилировщик добавляет к этому списку директории, заданные при помощи параметра — sd.

Видеооборудование.(-v)

Все параметры, начинающиеся с (-v) определяют то, как система Turbo Profiler работает с видеооборудованием.

— vg

Приводит к сохранению полных графических образов экранов программ. При задании этого параметра дополнительно занимаются 8К памяти, но это дает Вам возможность получать профили программ, использующих необычные графические режимы. Попробуйте задать этот параметр если при выполнении Вашей программы под управлением профилировщика происходит искажение ее графических экранов.

— vn

Отключает 43/50 — строчный режим дисплея. Задание этого параметра позволяет сэкономить некоторое количество памяти. Используйте параметр — vn в том случае, если Вы работаете с адаптером EGA или VGA и уверены в том, что не будете использовать в процессе профилирования 43-или 50-строчный режим.

— vp

Позволяет Вам сохранить палитру экрана, на который производит вывод Ваша программа при работе с EGA/VGA. Используйте этот параметр, если Ваша программа работает в необычных графических режимах адаптеров EGA и VGA.

Размер оверлейной области (-у)

При помощи параметров, начинающихся с — у, задается размер оверлейной области, расположенной либо в основной, либо в EMS памяти.

— yN

Этот параметр задает размер оверлейной области в основной памяти. Синтаксис задания этого параметра имеет следующий вид:

yN,

где N— это число килобайт, которое Вы хотите зарезервировать.

Обычно система Turbo Profiler использует для своего кода область памяти величиной 80К. Наименьший размер области, который Вы можете установить, равен 20К, а наибольший — 250К.

Применяйте этот параметр в случае нехватки памяти при загрузке Вашей программы в Turbo Profiler, или в том случае, когда Вы профилируете небольшую по размерам программу и хотите увеличить производительность системы Turbo Profiler. Чем меньше размер области памяти, отведенной для кода системы, тем чаще профилировщику приходится подгружать с диска оверлеи, и тем медленнее реакция системы Turbo Profiler на запросы пользователя. Чем больше размер этой области, тем меньшее количество памяти отдается в распоряжение профилируемой программы, но тем быстрее работает система Turbo Profiler.

— yeN

Этот параметр устанавливает размер оверлейной области в памяти EMS. Используйте этот параметр в случае необходимости освободить часть EMS— памяти для профилируемой программы. Синтаксис задания этого параметра имеет следующий вид:

— yeN,

где N— это число страниц EMS— памяти, размером по 16К, которые Вы хотите зарезервировать. Например параметр вида — ye4 устанавливает размер оверлейной области равным четырем страницам. По умолчанию этот размер устанавливается равным двенадцати страницам EMS-памяти, по 16К каждая.