Книга: Системное программирование в среде Windows

ПРИЛОЖЕНИЕ Б Сопоставление функций Windows, UNIX и библиотеки С

ПРИЛОЖЕНИЕ Б

Сопоставление функций Windows, UNIX и библиотеки С

В этом приложении приводятся таблицы, в которых представлены функции Windows (Win32 и Win64), описанные в основном тексте, а также сопоставимые с ними функции UNIX/Linux[36] и стандартной библиотеки ANSI С, если таковые имеются.

Таблицы расположены в порядке следования глав (некоторые таблицы объединяют данные, относящиеся к нескольким главам). В пределах каждой главы данные в таблицах отсортированы сначала в соответствии с их функциональным назначением (файловая система, управление каталогами и так далее), а затем по именам функций Windows.

В каждой из строк таблицы представлена следующая информация:

• Функциональная область (категория).

• Имя функции Windows.

• Имя соответствующей функции UNIX. В некоторых случаях существует несколько таких функций.

• Имя соответствующей функции библиотеки С, если таковая имеется.

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

• В библиотеке функций Microsoft Visual C++ содержатся некоторые функции, совместимые с UNIX. Так, функция _open является функцией библиотеки совместимости, эквивалентной UNIX-функции open. Выделение имени функции UNIX курсивом означает, что эта функция является совместимой. Символ звездочки в конце имени функции указывает на существование версии функции, ориентированной на работу с расширенными символами UNICODE. Так, существует функция _wopen.

• Программа, в которой используются только функции стандартной библиотеки С и отсутствуют вызовы функций Windows или UNIX, должны компилироваться, компоноваться и выполняться в обеих системах. В то же время, возможности такой программы в отношении работы с файлами и выполнения операций ввода/вывода будут ограниченными.

• Функция, следующая за разделительной запятой, является альтернативной версией, часто использующей другие характеристики или эмулирующей какой-то один из аспектов функции Windows.

• Разделение функций символом точки с запятой указывает на то, что эмуляция функции Windows достигается за счет последовательного использования этих функций. Так, функции CreateProcess соответствуют функции fork; exec.

• Подчеркивание имени элемента указывает на глобальную переменную, например errno.

• В некоторых случаях UNIX-эквивалент указывается в обобщенной форме с использованием такой, например, терминологии, как "функции терминального ввода/вывода" в случае Windows-функции AllocConsole. Часто приводится только соответствующий простой комментарий наподобие "Используйте библиотеку С", как это сделано в случае функции GetTempFileName. В других случаях ситуация обращается. Так, для функций управления сигналами в UNIX (функция sigaddset и подобные ей) в столбце "Windows" содержатся записи "Используйте SEH, VEH", означающие, что для обеспечения желаемого поведения программы программист должен установить структурные или векторные обработчики исключений и функции фильтров. В отличии от UNIX, группы процессов в Windows не поддерживаются, и в подобных случаях в столбце "Windows" ставится прочерк, что, впрочем, не помешало нам эмулировать отношения между процессами при управлении заданиями в главе 6.

• Многочисленные прочерки, особенно, когда они относятся к библиотеке С, встречаются в тех случаях, когда сопоставимые функции или наборы функций отсутствуют. Именно такая ситуация наблюдается, например, для функций управления каталогами.

• В таблицах к главам 7—10 в качестве функций UNIX фигурируют функции потоков POSIX (Pthreads), хотя они и не являются частью UNIX. Кроме того, хотя во многих реализациях UNIX имеются собственные объекты синхронизации, аналогичные событиям, мьютексам и семафорам, мы не пытались отразить их в таблицах.

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

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

Главы 2 и 3: управление файлами и каталогами

Область Windows UNIX Библиотека С Примечания
Консольный ввод/вывод AllocConsole Терминальный ввод/вывод -
Консольный ввод/вывод FreeConsole Терминальный ввод/вывод -
Консольный ввод/вывод ReadConsole read getc, scanf, gets
Консольный ввод/вывод SetConsoleMode ioctl -
Консольный ввод/вывод WriteConsole write putc, printf, puts
Управление каталогами CreateDirectory mkdir* - Создание нового каталога
Управление каталогами FindClose closedir* - Закрытие дескриптора поиска
Управление каталогами FindFirstFile opendir*, readdir* - Поиск первого файла, соответствующего шаблону
Управление каталогами FindNextFile readdir* - Поиск следующих файлов, соответствующих шаблону
Управление каталогами GetCurrentDirectory getcwd* -
Управление каталогами GetFullPathName - -
Управление каталогами GetSystemDirectory Известные пути доступа -
Управление каталогами RemoveDirectory rmdir, unlink* remove
Управление каталогами SearchPath Используйте opendir, readdir - Поиск указанного файла по указанному пути
Управление каталогами SetCurrentDirectory chdir*, fchdir - Смена рабочего каталога
Обработка ошибок FormatMessage strerror perror
Обработка ошибок GetLastError errno errno Глобальная переменная
Обработка ошибок SetLastError errno errno Глобальная переменная
Блокирование файлов LockFile fcntl(cmd=F_GETLK,…) -
Блокирование файлов LockFileEx fcntl(cmd=F_GETLK,…) -
Блокирование файлов UnlockFile fcntl(cmd=F_GETLK,…) -
Блокирование файлов UnlockFileEx fcntl(cmd=F_GETLK,…) -
Файловая система CloseHandle (в данном случае закрытие дескриптора файла) close* fclose CloseHandle не ограничивается файлами
Файловая система CopyFile open; read; write; close fopen; fread; fwrite; fclose Дублирование файла
Файловая система CreateFile open*, creat* fopen Открытие/ создание файла
Файловая система DeleteFile unlink* remove Удаление файла
Файловая система FlushFileBuffers fsynch fflush Запись буферизованных данных в файл
Файловая система GetFileAttributes stat*, fstat*, lstat -
Файловая система GetFileInformationByHandle stat*, fstat*, lstat - Заполнение структуры информацией о файле
Файловая система GetFileSize stat*, fstat*, lstat ftell, fseek Получение размера файла в байтах
Файловая система  GetFileTime stat*, fstat*, lstat -
Файловая система GetFileType stat*, fstat*, lstat - Определение типа устройства или файла
Файловая система GetStdHandle Используйте файловые дескрипторы 0, 1 или 2 Используйте stdin, stdout, stderr
Файловая система GetTempFileName Используйте библиотеку С tmpnam Создание уникального имени файла
Файловая система GetTempFileName, CreateFile Используйте библиотеку С tmpfile Создание временного файла
Файловая система GetTempPath /temp path - Получение пути к каталогу для временных файлов
Файловая система MoveFile, MoveFileEx Используйте библиотеку С rename Переименование файла или каталога
Файловая система CreateHardLink link, unlink* - Windows не поддерживает ссылки
Файловая система - symlink - Создание символической ссылки
Файловая система - readlink - Чтение имени в символической ссылке
Файловая система Отсутствует; ReadFile возвращает 0 байт Отсутствует; read возвращает 0 байт feof Количество оставшихся до конца файла байтов
Файловая система Отсутствует; используйте многократные вызовы ReadFile readv Отсутствует; используйте многократные вызовы freads Фрагментированное чтение
Файловая система Отсутствует; используйте многократные вызовы WriteFile writev Отсутствует; используйте многократные вызовы fwrites Запись со слиянием
Файловая система ReadFile read fread Чтение данных из файла
Файловая система SetEndOfFile chsize* -
Файловая система SetFileAttributes fcntl -
Файловая система SetFilePointer lseek fseek Установка указателя файла
Файловая система SetFilePointer (установка в 0) lseek(0) rewind
Файловая система SetFileTime utime* -
Файловая система SetStdHandle close, dup*, dup2* или fcntl freopen dup2 или fcntl
Файловая система WriteFile write fwrite Запись данных в файл
Получение сведений о системе GetDiskFreeSpace - -
Получение сведений о системе GetSystemInfo getrusage -
Получение сведений о системе GetVersion uname -
Получение сведений о системе GetVolumeInformation - -
Получение сведений о системе GlobalMemoryStatus getrlimit -
Получение сведений о системе Ряд предопределенных констант sysconf, pathconf, fpathconf -
Дата и время GetSystemTime Используйте библиотеку С time, gmtime
Дата и время См. программу ls (Программа 3.2) Используйте библиотеку С asctime
Дата и время CompareFileTime Используйте библиотеку С difftime Сравнение "календарных" значений даты и времени
Дата и время FileTimeToLocalFileTime, FileTimeToSystemTime Используйте библиотеку С localtime
Дата и время FileTimeToSystemTime Используйте библиотеку С gmtime
Дата и время GetLocalTime Используйте библиотеку С time, localtime
Дата и время См. программу touch (программа 3.3) Используйте библиотеку С strftime
Дата и время SetLocalTime - -
Дата и время SetSystemTime - -
Дата и время Вычитание значений отметок времени Используйте библиотеку С difftime
Дата и время SystemTimeToFileTime Используйте библиотеку С mktime

Глава 4: обработка исключений

Область Windows UNIX Библиотека С
SEH __try–__except Используйте сигналы библиотеки С Используйте сигналы библиотеки С
SEH __try–__finally Используйте сигналы библиотеки С Используйте сигналы библиотеки С
SEH AbnormalTermination Используйте сигналы библиотеки С Используйте сигналы библиотеки С
SEH GetExceptionCode Используйте сигналы библиотеки С Используйте сигналы библиотеки С
SEH RaiseException Используйте сигналы библиотеки С signal, raise
Сигналы Используйте блок __finally Используйте библиотеку С atexit
Сигналы Используйте библиотеку С или TerminateProcess kill raise
Сигналы Используйте библиотеку С Используйте библиотеку С signal
Сигналы Используйте SEH, VEH sigemptyset -
Сигналы Используйте SEH, VEH sigfillset -
Сигналы Используйте SEH, VEH sigaddset -
Сигналы Используйте SEH, VEH sigdelset -
Сигналы Используйте SEH, VEH sigismember -
Сигналы Используйте SEH, VEH sigprocmask -
Сигналы Используйте SEH, VEH sigpending -
Сигналы Используйте SEH, VEH sigaction -
Сигналы Используйте SEH, VEH sigsetjmp -
Сигналы Используйте SEH, VEH siglongjmp -
Сигналы Используйте SEH, VEH sigsuspendf -
Сигналы Используйте SEH, VEH psignal -
Сигналы Используйте SEH, VEH или библиотеку С Используйте библиотеку С abort

Примечание. Многие поставщики систем UNIX предоставляют собственные средства обработки исключений.

Глава 5: управление памятью, отображение файлов и библиотеки DLL

Область Windows UNIX Библиотека С
Отображение файлов CreateFileMapping shmget -
Отображение файлов MapViewOfFile mmap, shmat -
Отображение файлов MapViewOfFileEx mmap, shmat -
Отображение файлов OpenFileMapping shmget -
Отображение файлов UnmapViewOfFile munmap, shmdt, shmctl -
Управление памятью GetProcessHeap - -
Управление памятью GetSystemInfo - -
Управление памятью HeapAlloc sbrk, brk или библиотека С malloc, calloc
Управление памятью HeapCreate - -
Управление памятью HeapDestroy - -
Управление памятью HeapFree Используйте библиотеку С free
Управление памятью HeapReAlloc Используйте библиотеку С realloc
Управление памятью HeapSize - -
Разделяемая память CloseHandle (в данном случае закрытие дескриптора объекта отображения файла)  shmctl -
Разделяемая память CreateFileMapping, OpenFileMapping shmget -
Разделяемая память MapViewOfFile shmat -
Разделяемая память UnmapViewOfFile shmdt -
Библиотеки DLL LoadLibrary dlopen -
Библиотеки DLL FreeLibrary dlclose -
Библиотеки DLL GetProcAddress dlsyn -
Библиотеки DLL DllMain pthread_once -

Глава 6: управление процессами

Область Windows UNIX Библиотека С Примечания
Управление процессами CreateProcess fork(); execl()*, system() - Существует 6 функций ехесхх
Управление процессами ExitProcess _exit exit
Управление процессами GetCommandLine argv[] argv[]
Управление процессами GetCurrentProcess getpid* -
Управление процессами GetCurrentProcessId getpid* -
Управление процессами GetEnvironmentStrings  - getenv
Управление процессами GetEnvironmentVariable - getenv
Управление процессами GetExitCodeProcess wait, waitpid -
Управление процессами GetProcessTimes times, wait3, wait4 -
Управление процессами GetProcessWorkingSetSize wait3, wait4 -
Управление процессами - execl*,execv*,execle*,execve*,execlp*,execvp* - В Windows прямой эквивалент отсутствует
Управление процессами - fork, vfork - В Windows прямой эквивалент отсутствует
Управление процессами - getppid - Отношения "предок/потомок" в Windows отсутствуют
Управление процессами - getgid, getegid - Понятие группы процессов в Windows отсутствует
Управление процессами - getpgrp -
Управление процессами - setpgid -
Управление процессами - setsid -
Управление процессами - tcgetpgrp -
Управление процессами - tcsetpgrp -
Управление процессами OpenProcess  - -
Управление процессами SetEnvironmentVariable putenv - putenv не включена в стандартную библиотеку С
Управление процессами TerminateProcess kill -
Синхронизация: процесс WaitForMultipleObjects (в данном случае ожидание дескрипторов процесса) waitpid -
Синхронизация: процесс WaitForSingleObject (в данном случае ожидание дескриптора процесса) wait, waitpid -
Таймеры KillTimer alarm(0) -
Таймеры SetTimer alarm -
Таймеры Sleep sleep -
Таймеры Sleep poll или select без указания файлового дескриптора -

Глава 7: Потоки и планирование выполнения

Область Windows UNIX/Pthreads Примечания
Управление потоками CreateRemoteThread -
TLS TlsAlloc pthread_key_alloc
TLS TlsFree pthread_key_delete
TLS TlsGetValue pthread_getspecific
TLS TlsSetValue pthread_setspecific
Управление потоками CreateThread, _beginthreadex pthread_create
Управление потоками ExitThread, _endthreadex pthread_exit
Управление потоками GetCurrentThread pthread_self
Управление потоками GetCurrentThreadId -
Управление потоками GetExitCodeThread pthread_yield
Управление потоками ResumeThread -
Управление потоками SuspendThread -
Управление потоками TerminateThread pthread_cancel pthread_cancel является более безопасной
Управление потоками WaitForSingleObject (в данном случае ожидание дескриптора потока) pthread_join
Приоритет потоков GetPriorityClass pthread_attr_getschedpolicy, getpriority
Приоритет потоков GetThreadPriority pthread_attr_getschedparam
Приоритет потоков SetPriorityClass pthread_attr_setschedpolicy, setpriority, nice
Приоритет потоков SetThreadPriority pthread_attr_setschedparam

Примечание. Будучи частью всех современных систем UNIX, потоки Pthreads доступны также в системах, отличных от UNIX.

Главы 8-10: синхронизация потоков

Область Windows UNIX/Pthreads Примечания
Синхронизация: критические разделы DeleteCriticalSection Для эмуляции объектов критических разделов используйте мьютексы. Библиотека С в данном случае не применима
Синхронизация: критические разделы EnterCriticalSection Некоторые системы предоставляют собственные эквиваленты. Библиотека С в данном случае не применима
Синхронизация: критические разделы InitializeCriticalSection ?
Синхронизация: критические разделы LeaveCriticalSection
Синхронизация: события CloseHandle (в данном случае закрытие дескриптора события) pthread_cond_destroy
Синхронизация: события CreateEvent pthread_cond_init
Синхронизация: события PulseEvent pthread_cond_signal Вручную сбрасываемое событие
Синхронизация: события ResetEvent -
Синхронизация: события SetEvent pthread_cond_broadcast Автоматически сбрасываемое событие
Синхронизация: события WaitForSingleObject (в данном случае ожидание дескриптора события) pthread_cond_wait
Синхронизация: события WaitForSingleObject (в данном случае ожидание дескриптора события) pthread_timed_wait
Синхронизация: мьютексы CloseHandle (в данном случае закрытие дескриптора мьютекса) pthread_mutex_destroy
Синхронизация: мьютексы CreateMutex pthread_mutex_init
Синхронизация: мьютексы ReleaseMutex pthread_mutex_unlock
Синхронизация: мьютексы WaitForSingleObject(в данном случае ожидание дескриптора мьютекса) pthread_mutex_lock
Синхронизация: семафоры CreateSemaphore semget
Синхронизация: семафоры - semctl Непосредственная поддержка всех опций в Windows отсутствует
Синхронизация: семафоры OpenSemaphore semget
Синхронизация: семафоры ReleaseSemaphore semop (+)
Синхронизация: семафоры WaitForSingleObject (в данном случае закрытие дескриптора семафора) semop (-) Windows может выполнять ожидание только одного счетчика

Глава 11: Взаимодействие между процессами

Область Windows UNIX Библиотека С Примечания
IPC CallNamedPipe - - CreateFile, WriteFile, ReadFile, CloseHandle
IPC CloseHandle (pipe handle) close, msgctl pclose
IPC ConnectNamedPipe - -
IPC CreateMailslot - -
IPC CreateNamedPipe mkfifo, msgget -
IPC CreatePipe pipe popen He является частью стандартной библиотеки С — см. [40]
IPC DuplicateHandle dup, dup2, or fcntl - Или используйте стандартные имена файлов CONIN$, CONOUT$
IPC GetNamedPipeHandleState stat, fstat, lstat64 -
IPC GetNamedPipeInfo stat, fstat, lstat -
IPC ImpersonateNamedPipeClient - -
IPC PeekNamedPipe - -
IPC ReadFile (в данном случае используется дескриптор именованного канала) read (fifo), msgsnd -
IPC RevertToSelf - -
IPC SetNamedPipeHandleState - -
IPC TransactNamedPipe - - WriteFile; ReadFile
IPC WriteFile (в данном случае используется дескриптор именованного канала) write (fifo), msgrcv -
Разное GetComputerName uname -
Разное SetComputerName - -
Безопасность SetNamedPipeIdentity Используйте второй промежуточный бит каталога -

Глава 14: асинхронный ввод/вывод

Область Windows UNIX Библиотека С Примечания
Асинхронный ввод/вывод GetOverlappedResult - -
Асинхронный ввод/вывод ReadFileEx - - Расширенный ввод/ вывод с процедурой завершения
Асинхронный ввод/вывод SleepEx - - Ожидание в дежурном режиме
Асинхронный ввод/вывод WaitForMultipleObjects (в данном случае ожидание дескрипторов файлов) poll, select -
Асинхронный ввод/вывод WaitForMultipleObjectsEx - - Ожидание в дежурном режиме
Асинхронный ввод/вывод WriteFileEx - - Расширенный ввод/ вывод с процедурой завершения
Асинхронный ввод/вывод WaitForSingleObjectEx waitpid - Ожидание в дежурном режиме

Глава 15: Безопасность объектов Windows

Область Windows UNIX Примечания
Безопасность AddAccessAllowedAce chmod, fchmod Средства защиты объектов библиотекой С не поддерживаются
Безопасность AddAccessDeniedAce chmod, fchmod
Безопасность AddAuditAce -
Безопасность CreatePrivateObjectSecurity -
Безопасность DeleteAce chmod, fchmod ?
Безопасность DestroyPrivateObjectSecurity -
Безопасность GetAce stat*, fstat*, lstat
Безопасность GetAclInformation stat*, fstat*, lstat
Безопасность GetFileSecurity stat*, fstat*, lstat
Безопасность GetPrivateObjectSecurity -
Безопасность GetSecurityDescriptorDacl stat*, fstat*, lstat
Безопасность GetUserName getlogin
Безопасность InitializeAcl -
Безопасность InitializeSecurityDescriptor umask
Безопасность LookupAccountName getpwnam, getgrnam
Безопасность LookupAccountSid getpwuid, getuid, geteuid
Безопасность - getpwend, setpwent, endpwent
Безопасность - getgrent, setgrent, endgrent
Безопасность - setuid, seteuid, setreuid
Безопасность - setgid, setegid, setregid
Безопасность OpenProcessToken getgroups, setgroups, initgroups
Безопасность SetFileSecurity chmod*, fchmod
Безопасность SetPrivateObjectSecurity -
Безопасность SetSecurityDescriptorDacl umask
Безопасность SetSecurityDescriptorGroup chown, fchown, lchown
Безопасность SetSecurityDescriptorOwner chown, fchown, lchown
Безопасность SetSecurityDescriptorSacl -

Оглавление книги

Оглавление статьи/книги

Генерация: 1.274. Запросов К БД/Cache: 3 / 1
поделиться
Вверх Вниз