syscall_windows.go 80 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834
  1. // Copyright 2009 The Go Authors. All rights reserved.
  2. // Use of this source code is governed by a BSD-style
  3. // license that can be found in the LICENSE file.
  4. // Windows system calls.
  5. package windows
  6. import (
  7. errorspkg "errors"
  8. "fmt"
  9. "runtime"
  10. "sync"
  11. "syscall"
  12. "time"
  13. "unicode/utf16"
  14. "unsafe"
  15. )
  16. type Handle uintptr
  17. type HWND uintptr
  18. const (
  19. InvalidHandle = ^Handle(0)
  20. InvalidHWND = ^HWND(0)
  21. // Flags for DefineDosDevice.
  22. DDD_EXACT_MATCH_ON_REMOVE = 0x00000004
  23. DDD_NO_BROADCAST_SYSTEM = 0x00000008
  24. DDD_RAW_TARGET_PATH = 0x00000001
  25. DDD_REMOVE_DEFINITION = 0x00000002
  26. // Return values for GetDriveType.
  27. DRIVE_UNKNOWN = 0
  28. DRIVE_NO_ROOT_DIR = 1
  29. DRIVE_REMOVABLE = 2
  30. DRIVE_FIXED = 3
  31. DRIVE_REMOTE = 4
  32. DRIVE_CDROM = 5
  33. DRIVE_RAMDISK = 6
  34. // File system flags from GetVolumeInformation and GetVolumeInformationByHandle.
  35. FILE_CASE_SENSITIVE_SEARCH = 0x00000001
  36. FILE_CASE_PRESERVED_NAMES = 0x00000002
  37. FILE_FILE_COMPRESSION = 0x00000010
  38. FILE_DAX_VOLUME = 0x20000000
  39. FILE_NAMED_STREAMS = 0x00040000
  40. FILE_PERSISTENT_ACLS = 0x00000008
  41. FILE_READ_ONLY_VOLUME = 0x00080000
  42. FILE_SEQUENTIAL_WRITE_ONCE = 0x00100000
  43. FILE_SUPPORTS_ENCRYPTION = 0x00020000
  44. FILE_SUPPORTS_EXTENDED_ATTRIBUTES = 0x00800000
  45. FILE_SUPPORTS_HARD_LINKS = 0x00400000
  46. FILE_SUPPORTS_OBJECT_IDS = 0x00010000
  47. FILE_SUPPORTS_OPEN_BY_FILE_ID = 0x01000000
  48. FILE_SUPPORTS_REPARSE_POINTS = 0x00000080
  49. FILE_SUPPORTS_SPARSE_FILES = 0x00000040
  50. FILE_SUPPORTS_TRANSACTIONS = 0x00200000
  51. FILE_SUPPORTS_USN_JOURNAL = 0x02000000
  52. FILE_UNICODE_ON_DISK = 0x00000004
  53. FILE_VOLUME_IS_COMPRESSED = 0x00008000
  54. FILE_VOLUME_QUOTAS = 0x00000020
  55. // Flags for LockFileEx.
  56. LOCKFILE_FAIL_IMMEDIATELY = 0x00000001
  57. LOCKFILE_EXCLUSIVE_LOCK = 0x00000002
  58. // Return value of SleepEx and other APC functions
  59. WAIT_IO_COMPLETION = 0x000000C0
  60. )
  61. // StringToUTF16 is deprecated. Use UTF16FromString instead.
  62. // If s contains a NUL byte this function panics instead of
  63. // returning an error.
  64. func StringToUTF16(s string) []uint16 {
  65. a, err := UTF16FromString(s)
  66. if err != nil {
  67. panic("windows: string with NUL passed to StringToUTF16")
  68. }
  69. return a
  70. }
  71. // UTF16FromString returns the UTF-16 encoding of the UTF-8 string
  72. // s, with a terminating NUL added. If s contains a NUL byte at any
  73. // location, it returns (nil, syscall.EINVAL).
  74. func UTF16FromString(s string) ([]uint16, error) {
  75. return syscall.UTF16FromString(s)
  76. }
  77. // UTF16ToString returns the UTF-8 encoding of the UTF-16 sequence s,
  78. // with a terminating NUL and any bytes after the NUL removed.
  79. func UTF16ToString(s []uint16) string {
  80. return syscall.UTF16ToString(s)
  81. }
  82. // StringToUTF16Ptr is deprecated. Use UTF16PtrFromString instead.
  83. // If s contains a NUL byte this function panics instead of
  84. // returning an error.
  85. func StringToUTF16Ptr(s string) *uint16 { return &StringToUTF16(s)[0] }
  86. // UTF16PtrFromString returns pointer to the UTF-16 encoding of
  87. // the UTF-8 string s, with a terminating NUL added. If s
  88. // contains a NUL byte at any location, it returns (nil, syscall.EINVAL).
  89. func UTF16PtrFromString(s string) (*uint16, error) {
  90. a, err := UTF16FromString(s)
  91. if err != nil {
  92. return nil, err
  93. }
  94. return &a[0], nil
  95. }
  96. // UTF16PtrToString takes a pointer to a UTF-16 sequence and returns the corresponding UTF-8 encoded string.
  97. // If the pointer is nil, it returns the empty string. It assumes that the UTF-16 sequence is terminated
  98. // at a zero word; if the zero word is not present, the program may crash.
  99. func UTF16PtrToString(p *uint16) string {
  100. if p == nil {
  101. return ""
  102. }
  103. if *p == 0 {
  104. return ""
  105. }
  106. // Find NUL terminator.
  107. n := 0
  108. for ptr := unsafe.Pointer(p); *(*uint16)(ptr) != 0; n++ {
  109. ptr = unsafe.Pointer(uintptr(ptr) + unsafe.Sizeof(*p))
  110. }
  111. return string(utf16.Decode(unsafe.Slice(p, n)))
  112. }
  113. func Getpagesize() int { return 4096 }
  114. // NewCallback converts a Go function to a function pointer conforming to the stdcall calling convention.
  115. // This is useful when interoperating with Windows code requiring callbacks.
  116. // The argument is expected to be a function with one uintptr-sized result. The function must not have arguments with size larger than the size of uintptr.
  117. func NewCallback(fn interface{}) uintptr {
  118. return syscall.NewCallback(fn)
  119. }
  120. // NewCallbackCDecl converts a Go function to a function pointer conforming to the cdecl calling convention.
  121. // This is useful when interoperating with Windows code requiring callbacks.
  122. // The argument is expected to be a function with one uintptr-sized result. The function must not have arguments with size larger than the size of uintptr.
  123. func NewCallbackCDecl(fn interface{}) uintptr {
  124. return syscall.NewCallbackCDecl(fn)
  125. }
  126. // windows api calls
  127. //sys GetLastError() (lasterr error)
  128. //sys LoadLibrary(libname string) (handle Handle, err error) = LoadLibraryW
  129. //sys LoadLibraryEx(libname string, zero Handle, flags uintptr) (handle Handle, err error) = LoadLibraryExW
  130. //sys FreeLibrary(handle Handle) (err error)
  131. //sys GetProcAddress(module Handle, procname string) (proc uintptr, err error)
  132. //sys GetModuleFileName(module Handle, filename *uint16, size uint32) (n uint32, err error) = kernel32.GetModuleFileNameW
  133. //sys GetModuleHandleEx(flags uint32, moduleName *uint16, module *Handle) (err error) = kernel32.GetModuleHandleExW
  134. //sys SetDefaultDllDirectories(directoryFlags uint32) (err error)
  135. //sys SetDllDirectory(path string) (err error) = kernel32.SetDllDirectoryW
  136. //sys GetVersion() (ver uint32, err error)
  137. //sys FormatMessage(flags uint32, msgsrc uintptr, msgid uint32, langid uint32, buf []uint16, args *byte) (n uint32, err error) = FormatMessageW
  138. //sys ExitProcess(exitcode uint32)
  139. //sys IsWow64Process(handle Handle, isWow64 *bool) (err error) = IsWow64Process
  140. //sys IsWow64Process2(handle Handle, processMachine *uint16, nativeMachine *uint16) (err error) = IsWow64Process2?
  141. //sys CreateFile(name *uint16, access uint32, mode uint32, sa *SecurityAttributes, createmode uint32, attrs uint32, templatefile Handle) (handle Handle, err error) [failretval==InvalidHandle] = CreateFileW
  142. //sys CreateNamedPipe(name *uint16, flags uint32, pipeMode uint32, maxInstances uint32, outSize uint32, inSize uint32, defaultTimeout uint32, sa *SecurityAttributes) (handle Handle, err error) [failretval==InvalidHandle] = CreateNamedPipeW
  143. //sys ConnectNamedPipe(pipe Handle, overlapped *Overlapped) (err error)
  144. //sys GetNamedPipeInfo(pipe Handle, flags *uint32, outSize *uint32, inSize *uint32, maxInstances *uint32) (err error)
  145. //sys GetNamedPipeHandleState(pipe Handle, state *uint32, curInstances *uint32, maxCollectionCount *uint32, collectDataTimeout *uint32, userName *uint16, maxUserNameSize uint32) (err error) = GetNamedPipeHandleStateW
  146. //sys SetNamedPipeHandleState(pipe Handle, state *uint32, maxCollectionCount *uint32, collectDataTimeout *uint32) (err error) = SetNamedPipeHandleState
  147. //sys readFile(handle Handle, buf []byte, done *uint32, overlapped *Overlapped) (err error) = ReadFile
  148. //sys writeFile(handle Handle, buf []byte, done *uint32, overlapped *Overlapped) (err error) = WriteFile
  149. //sys GetOverlappedResult(handle Handle, overlapped *Overlapped, done *uint32, wait bool) (err error)
  150. //sys SetFilePointer(handle Handle, lowoffset int32, highoffsetptr *int32, whence uint32) (newlowoffset uint32, err error) [failretval==0xffffffff]
  151. //sys CloseHandle(handle Handle) (err error)
  152. //sys GetStdHandle(stdhandle uint32) (handle Handle, err error) [failretval==InvalidHandle]
  153. //sys SetStdHandle(stdhandle uint32, handle Handle) (err error)
  154. //sys findFirstFile1(name *uint16, data *win32finddata1) (handle Handle, err error) [failretval==InvalidHandle] = FindFirstFileW
  155. //sys findNextFile1(handle Handle, data *win32finddata1) (err error) = FindNextFileW
  156. //sys FindClose(handle Handle) (err error)
  157. //sys GetFileInformationByHandle(handle Handle, data *ByHandleFileInformation) (err error)
  158. //sys GetFileInformationByHandleEx(handle Handle, class uint32, outBuffer *byte, outBufferLen uint32) (err error)
  159. //sys SetFileInformationByHandle(handle Handle, class uint32, inBuffer *byte, inBufferLen uint32) (err error)
  160. //sys GetCurrentDirectory(buflen uint32, buf *uint16) (n uint32, err error) = GetCurrentDirectoryW
  161. //sys SetCurrentDirectory(path *uint16) (err error) = SetCurrentDirectoryW
  162. //sys CreateDirectory(path *uint16, sa *SecurityAttributes) (err error) = CreateDirectoryW
  163. //sys RemoveDirectory(path *uint16) (err error) = RemoveDirectoryW
  164. //sys DeleteFile(path *uint16) (err error) = DeleteFileW
  165. //sys MoveFile(from *uint16, to *uint16) (err error) = MoveFileW
  166. //sys MoveFileEx(from *uint16, to *uint16, flags uint32) (err error) = MoveFileExW
  167. //sys LockFileEx(file Handle, flags uint32, reserved uint32, bytesLow uint32, bytesHigh uint32, overlapped *Overlapped) (err error)
  168. //sys UnlockFileEx(file Handle, reserved uint32, bytesLow uint32, bytesHigh uint32, overlapped *Overlapped) (err error)
  169. //sys GetComputerName(buf *uint16, n *uint32) (err error) = GetComputerNameW
  170. //sys GetComputerNameEx(nametype uint32, buf *uint16, n *uint32) (err error) = GetComputerNameExW
  171. //sys SetEndOfFile(handle Handle) (err error)
  172. //sys GetSystemTimeAsFileTime(time *Filetime)
  173. //sys GetSystemTimePreciseAsFileTime(time *Filetime)
  174. //sys GetTimeZoneInformation(tzi *Timezoneinformation) (rc uint32, err error) [failretval==0xffffffff]
  175. //sys CreateIoCompletionPort(filehandle Handle, cphandle Handle, key uintptr, threadcnt uint32) (handle Handle, err error)
  176. //sys GetQueuedCompletionStatus(cphandle Handle, qty *uint32, key *uintptr, overlapped **Overlapped, timeout uint32) (err error)
  177. //sys PostQueuedCompletionStatus(cphandle Handle, qty uint32, key uintptr, overlapped *Overlapped) (err error)
  178. //sys CancelIo(s Handle) (err error)
  179. //sys CancelIoEx(s Handle, o *Overlapped) (err error)
  180. //sys CreateProcess(appName *uint16, commandLine *uint16, procSecurity *SecurityAttributes, threadSecurity *SecurityAttributes, inheritHandles bool, creationFlags uint32, env *uint16, currentDir *uint16, startupInfo *StartupInfo, outProcInfo *ProcessInformation) (err error) = CreateProcessW
  181. //sys CreateProcessAsUser(token Token, appName *uint16, commandLine *uint16, procSecurity *SecurityAttributes, threadSecurity *SecurityAttributes, inheritHandles bool, creationFlags uint32, env *uint16, currentDir *uint16, startupInfo *StartupInfo, outProcInfo *ProcessInformation) (err error) = advapi32.CreateProcessAsUserW
  182. //sys initializeProcThreadAttributeList(attrlist *ProcThreadAttributeList, attrcount uint32, flags uint32, size *uintptr) (err error) = InitializeProcThreadAttributeList
  183. //sys deleteProcThreadAttributeList(attrlist *ProcThreadAttributeList) = DeleteProcThreadAttributeList
  184. //sys updateProcThreadAttribute(attrlist *ProcThreadAttributeList, flags uint32, attr uintptr, value unsafe.Pointer, size uintptr, prevvalue unsafe.Pointer, returnedsize *uintptr) (err error) = UpdateProcThreadAttribute
  185. //sys OpenProcess(desiredAccess uint32, inheritHandle bool, processId uint32) (handle Handle, err error)
  186. //sys ShellExecute(hwnd Handle, verb *uint16, file *uint16, args *uint16, cwd *uint16, showCmd int32) (err error) [failretval<=32] = shell32.ShellExecuteW
  187. //sys GetWindowThreadProcessId(hwnd HWND, pid *uint32) (tid uint32, err error) = user32.GetWindowThreadProcessId
  188. //sys GetShellWindow() (shellWindow HWND) = user32.GetShellWindow
  189. //sys MessageBox(hwnd HWND, text *uint16, caption *uint16, boxtype uint32) (ret int32, err error) [failretval==0] = user32.MessageBoxW
  190. //sys ExitWindowsEx(flags uint32, reason uint32) (err error) = user32.ExitWindowsEx
  191. //sys shGetKnownFolderPath(id *KNOWNFOLDERID, flags uint32, token Token, path **uint16) (ret error) = shell32.SHGetKnownFolderPath
  192. //sys TerminateProcess(handle Handle, exitcode uint32) (err error)
  193. //sys GetExitCodeProcess(handle Handle, exitcode *uint32) (err error)
  194. //sys getStartupInfo(startupInfo *StartupInfo) = GetStartupInfoW
  195. //sys GetProcessTimes(handle Handle, creationTime *Filetime, exitTime *Filetime, kernelTime *Filetime, userTime *Filetime) (err error)
  196. //sys DuplicateHandle(hSourceProcessHandle Handle, hSourceHandle Handle, hTargetProcessHandle Handle, lpTargetHandle *Handle, dwDesiredAccess uint32, bInheritHandle bool, dwOptions uint32) (err error)
  197. //sys WaitForSingleObject(handle Handle, waitMilliseconds uint32) (event uint32, err error) [failretval==0xffffffff]
  198. //sys waitForMultipleObjects(count uint32, handles uintptr, waitAll bool, waitMilliseconds uint32) (event uint32, err error) [failretval==0xffffffff] = WaitForMultipleObjects
  199. //sys GetTempPath(buflen uint32, buf *uint16) (n uint32, err error) = GetTempPathW
  200. //sys CreatePipe(readhandle *Handle, writehandle *Handle, sa *SecurityAttributes, size uint32) (err error)
  201. //sys GetFileType(filehandle Handle) (n uint32, err error)
  202. //sys CryptAcquireContext(provhandle *Handle, container *uint16, provider *uint16, provtype uint32, flags uint32) (err error) = advapi32.CryptAcquireContextW
  203. //sys CryptReleaseContext(provhandle Handle, flags uint32) (err error) = advapi32.CryptReleaseContext
  204. //sys CryptGenRandom(provhandle Handle, buflen uint32, buf *byte) (err error) = advapi32.CryptGenRandom
  205. //sys GetEnvironmentStrings() (envs *uint16, err error) [failretval==nil] = kernel32.GetEnvironmentStringsW
  206. //sys FreeEnvironmentStrings(envs *uint16) (err error) = kernel32.FreeEnvironmentStringsW
  207. //sys GetEnvironmentVariable(name *uint16, buffer *uint16, size uint32) (n uint32, err error) = kernel32.GetEnvironmentVariableW
  208. //sys SetEnvironmentVariable(name *uint16, value *uint16) (err error) = kernel32.SetEnvironmentVariableW
  209. //sys ExpandEnvironmentStrings(src *uint16, dst *uint16, size uint32) (n uint32, err error) = kernel32.ExpandEnvironmentStringsW
  210. //sys CreateEnvironmentBlock(block **uint16, token Token, inheritExisting bool) (err error) = userenv.CreateEnvironmentBlock
  211. //sys DestroyEnvironmentBlock(block *uint16) (err error) = userenv.DestroyEnvironmentBlock
  212. //sys getTickCount64() (ms uint64) = kernel32.GetTickCount64
  213. //sys GetFileTime(handle Handle, ctime *Filetime, atime *Filetime, wtime *Filetime) (err error)
  214. //sys SetFileTime(handle Handle, ctime *Filetime, atime *Filetime, wtime *Filetime) (err error)
  215. //sys GetFileAttributes(name *uint16) (attrs uint32, err error) [failretval==INVALID_FILE_ATTRIBUTES] = kernel32.GetFileAttributesW
  216. //sys SetFileAttributes(name *uint16, attrs uint32) (err error) = kernel32.SetFileAttributesW
  217. //sys GetFileAttributesEx(name *uint16, level uint32, info *byte) (err error) = kernel32.GetFileAttributesExW
  218. //sys GetCommandLine() (cmd *uint16) = kernel32.GetCommandLineW
  219. //sys commandLineToArgv(cmd *uint16, argc *int32) (argv **uint16, err error) [failretval==nil] = shell32.CommandLineToArgvW
  220. //sys LocalFree(hmem Handle) (handle Handle, err error) [failretval!=0]
  221. //sys LocalAlloc(flags uint32, length uint32) (ptr uintptr, err error)
  222. //sys SetHandleInformation(handle Handle, mask uint32, flags uint32) (err error)
  223. //sys FlushFileBuffers(handle Handle) (err error)
  224. //sys GetFullPathName(path *uint16, buflen uint32, buf *uint16, fname **uint16) (n uint32, err error) = kernel32.GetFullPathNameW
  225. //sys GetLongPathName(path *uint16, buf *uint16, buflen uint32) (n uint32, err error) = kernel32.GetLongPathNameW
  226. //sys GetShortPathName(longpath *uint16, shortpath *uint16, buflen uint32) (n uint32, err error) = kernel32.GetShortPathNameW
  227. //sys GetFinalPathNameByHandle(file Handle, filePath *uint16, filePathSize uint32, flags uint32) (n uint32, err error) = kernel32.GetFinalPathNameByHandleW
  228. //sys CreateFileMapping(fhandle Handle, sa *SecurityAttributes, prot uint32, maxSizeHigh uint32, maxSizeLow uint32, name *uint16) (handle Handle, err error) [failretval == 0 || e1 == ERROR_ALREADY_EXISTS] = kernel32.CreateFileMappingW
  229. //sys MapViewOfFile(handle Handle, access uint32, offsetHigh uint32, offsetLow uint32, length uintptr) (addr uintptr, err error)
  230. //sys UnmapViewOfFile(addr uintptr) (err error)
  231. //sys FlushViewOfFile(addr uintptr, length uintptr) (err error)
  232. //sys VirtualLock(addr uintptr, length uintptr) (err error)
  233. //sys VirtualUnlock(addr uintptr, length uintptr) (err error)
  234. //sys VirtualAlloc(address uintptr, size uintptr, alloctype uint32, protect uint32) (value uintptr, err error) = kernel32.VirtualAlloc
  235. //sys VirtualFree(address uintptr, size uintptr, freetype uint32) (err error) = kernel32.VirtualFree
  236. //sys VirtualProtect(address uintptr, size uintptr, newprotect uint32, oldprotect *uint32) (err error) = kernel32.VirtualProtect
  237. //sys VirtualProtectEx(process Handle, address uintptr, size uintptr, newProtect uint32, oldProtect *uint32) (err error) = kernel32.VirtualProtectEx
  238. //sys VirtualQuery(address uintptr, buffer *MemoryBasicInformation, length uintptr) (err error) = kernel32.VirtualQuery
  239. //sys VirtualQueryEx(process Handle, address uintptr, buffer *MemoryBasicInformation, length uintptr) (err error) = kernel32.VirtualQueryEx
  240. //sys ReadProcessMemory(process Handle, baseAddress uintptr, buffer *byte, size uintptr, numberOfBytesRead *uintptr) (err error) = kernel32.ReadProcessMemory
  241. //sys WriteProcessMemory(process Handle, baseAddress uintptr, buffer *byte, size uintptr, numberOfBytesWritten *uintptr) (err error) = kernel32.WriteProcessMemory
  242. //sys TransmitFile(s Handle, handle Handle, bytesToWrite uint32, bytsPerSend uint32, overlapped *Overlapped, transmitFileBuf *TransmitFileBuffers, flags uint32) (err error) = mswsock.TransmitFile
  243. //sys ReadDirectoryChanges(handle Handle, buf *byte, buflen uint32, watchSubTree bool, mask uint32, retlen *uint32, overlapped *Overlapped, completionRoutine uintptr) (err error) = kernel32.ReadDirectoryChangesW
  244. //sys FindFirstChangeNotification(path string, watchSubtree bool, notifyFilter uint32) (handle Handle, err error) [failretval==InvalidHandle] = kernel32.FindFirstChangeNotificationW
  245. //sys FindNextChangeNotification(handle Handle) (err error)
  246. //sys FindCloseChangeNotification(handle Handle) (err error)
  247. //sys CertOpenSystemStore(hprov Handle, name *uint16) (store Handle, err error) = crypt32.CertOpenSystemStoreW
  248. //sys CertOpenStore(storeProvider uintptr, msgAndCertEncodingType uint32, cryptProv uintptr, flags uint32, para uintptr) (handle Handle, err error) = crypt32.CertOpenStore
  249. //sys CertEnumCertificatesInStore(store Handle, prevContext *CertContext) (context *CertContext, err error) [failretval==nil] = crypt32.CertEnumCertificatesInStore
  250. //sys CertAddCertificateContextToStore(store Handle, certContext *CertContext, addDisposition uint32, storeContext **CertContext) (err error) = crypt32.CertAddCertificateContextToStore
  251. //sys CertCloseStore(store Handle, flags uint32) (err error) = crypt32.CertCloseStore
  252. //sys CertDeleteCertificateFromStore(certContext *CertContext) (err error) = crypt32.CertDeleteCertificateFromStore
  253. //sys CertDuplicateCertificateContext(certContext *CertContext) (dupContext *CertContext) = crypt32.CertDuplicateCertificateContext
  254. //sys PFXImportCertStore(pfx *CryptDataBlob, password *uint16, flags uint32) (store Handle, err error) = crypt32.PFXImportCertStore
  255. //sys CertGetCertificateChain(engine Handle, leaf *CertContext, time *Filetime, additionalStore Handle, para *CertChainPara, flags uint32, reserved uintptr, chainCtx **CertChainContext) (err error) = crypt32.CertGetCertificateChain
  256. //sys CertFreeCertificateChain(ctx *CertChainContext) = crypt32.CertFreeCertificateChain
  257. //sys CertCreateCertificateContext(certEncodingType uint32, certEncoded *byte, encodedLen uint32) (context *CertContext, err error) [failretval==nil] = crypt32.CertCreateCertificateContext
  258. //sys CertFreeCertificateContext(ctx *CertContext) (err error) = crypt32.CertFreeCertificateContext
  259. //sys CertVerifyCertificateChainPolicy(policyOID uintptr, chain *CertChainContext, para *CertChainPolicyPara, status *CertChainPolicyStatus) (err error) = crypt32.CertVerifyCertificateChainPolicy
  260. //sys CertGetNameString(certContext *CertContext, nameType uint32, flags uint32, typePara unsafe.Pointer, name *uint16, size uint32) (chars uint32) = crypt32.CertGetNameStringW
  261. //sys CertFindExtension(objId *byte, countExtensions uint32, extensions *CertExtension) (ret *CertExtension) = crypt32.CertFindExtension
  262. //sys CertFindCertificateInStore(store Handle, certEncodingType uint32, findFlags uint32, findType uint32, findPara unsafe.Pointer, prevCertContext *CertContext) (cert *CertContext, err error) [failretval==nil] = crypt32.CertFindCertificateInStore
  263. //sys CertFindChainInStore(store Handle, certEncodingType uint32, findFlags uint32, findType uint32, findPara unsafe.Pointer, prevChainContext *CertChainContext) (certchain *CertChainContext, err error) [failretval==nil] = crypt32.CertFindChainInStore
  264. //sys CryptAcquireCertificatePrivateKey(cert *CertContext, flags uint32, parameters unsafe.Pointer, cryptProvOrNCryptKey *Handle, keySpec *uint32, callerFreeProvOrNCryptKey *bool) (err error) = crypt32.CryptAcquireCertificatePrivateKey
  265. //sys CryptQueryObject(objectType uint32, object unsafe.Pointer, expectedContentTypeFlags uint32, expectedFormatTypeFlags uint32, flags uint32, msgAndCertEncodingType *uint32, contentType *uint32, formatType *uint32, certStore *Handle, msg *Handle, context *unsafe.Pointer) (err error) = crypt32.CryptQueryObject
  266. //sys CryptDecodeObject(encodingType uint32, structType *byte, encodedBytes *byte, lenEncodedBytes uint32, flags uint32, decoded unsafe.Pointer, decodedLen *uint32) (err error) = crypt32.CryptDecodeObject
  267. //sys CryptProtectData(dataIn *DataBlob, name *uint16, optionalEntropy *DataBlob, reserved uintptr, promptStruct *CryptProtectPromptStruct, flags uint32, dataOut *DataBlob) (err error) = crypt32.CryptProtectData
  268. //sys CryptUnprotectData(dataIn *DataBlob, name **uint16, optionalEntropy *DataBlob, reserved uintptr, promptStruct *CryptProtectPromptStruct, flags uint32, dataOut *DataBlob) (err error) = crypt32.CryptUnprotectData
  269. //sys WinVerifyTrustEx(hwnd HWND, actionId *GUID, data *WinTrustData) (ret error) = wintrust.WinVerifyTrustEx
  270. //sys RegOpenKeyEx(key Handle, subkey *uint16, options uint32, desiredAccess uint32, result *Handle) (regerrno error) = advapi32.RegOpenKeyExW
  271. //sys RegCloseKey(key Handle) (regerrno error) = advapi32.RegCloseKey
  272. //sys RegQueryInfoKey(key Handle, class *uint16, classLen *uint32, reserved *uint32, subkeysLen *uint32, maxSubkeyLen *uint32, maxClassLen *uint32, valuesLen *uint32, maxValueNameLen *uint32, maxValueLen *uint32, saLen *uint32, lastWriteTime *Filetime) (regerrno error) = advapi32.RegQueryInfoKeyW
  273. //sys RegEnumKeyEx(key Handle, index uint32, name *uint16, nameLen *uint32, reserved *uint32, class *uint16, classLen *uint32, lastWriteTime *Filetime) (regerrno error) = advapi32.RegEnumKeyExW
  274. //sys RegQueryValueEx(key Handle, name *uint16, reserved *uint32, valtype *uint32, buf *byte, buflen *uint32) (regerrno error) = advapi32.RegQueryValueExW
  275. //sys RegNotifyChangeKeyValue(key Handle, watchSubtree bool, notifyFilter uint32, event Handle, asynchronous bool) (regerrno error) = advapi32.RegNotifyChangeKeyValue
  276. //sys GetCurrentProcessId() (pid uint32) = kernel32.GetCurrentProcessId
  277. //sys ProcessIdToSessionId(pid uint32, sessionid *uint32) (err error) = kernel32.ProcessIdToSessionId
  278. //sys ClosePseudoConsole(console Handle) = kernel32.ClosePseudoConsole
  279. //sys createPseudoConsole(size uint32, in Handle, out Handle, flags uint32, pconsole *Handle) (hr error) = kernel32.CreatePseudoConsole
  280. //sys GetConsoleMode(console Handle, mode *uint32) (err error) = kernel32.GetConsoleMode
  281. //sys SetConsoleMode(console Handle, mode uint32) (err error) = kernel32.SetConsoleMode
  282. //sys GetConsoleScreenBufferInfo(console Handle, info *ConsoleScreenBufferInfo) (err error) = kernel32.GetConsoleScreenBufferInfo
  283. //sys setConsoleCursorPosition(console Handle, position uint32) (err error) = kernel32.SetConsoleCursorPosition
  284. //sys WriteConsole(console Handle, buf *uint16, towrite uint32, written *uint32, reserved *byte) (err error) = kernel32.WriteConsoleW
  285. //sys ReadConsole(console Handle, buf *uint16, toread uint32, read *uint32, inputControl *byte) (err error) = kernel32.ReadConsoleW
  286. //sys resizePseudoConsole(pconsole Handle, size uint32) (hr error) = kernel32.ResizePseudoConsole
  287. //sys CreateToolhelp32Snapshot(flags uint32, processId uint32) (handle Handle, err error) [failretval==InvalidHandle] = kernel32.CreateToolhelp32Snapshot
  288. //sys Module32First(snapshot Handle, moduleEntry *ModuleEntry32) (err error) = kernel32.Module32FirstW
  289. //sys Module32Next(snapshot Handle, moduleEntry *ModuleEntry32) (err error) = kernel32.Module32NextW
  290. //sys Process32First(snapshot Handle, procEntry *ProcessEntry32) (err error) = kernel32.Process32FirstW
  291. //sys Process32Next(snapshot Handle, procEntry *ProcessEntry32) (err error) = kernel32.Process32NextW
  292. //sys Thread32First(snapshot Handle, threadEntry *ThreadEntry32) (err error)
  293. //sys Thread32Next(snapshot Handle, threadEntry *ThreadEntry32) (err error)
  294. //sys DeviceIoControl(handle Handle, ioControlCode uint32, inBuffer *byte, inBufferSize uint32, outBuffer *byte, outBufferSize uint32, bytesReturned *uint32, overlapped *Overlapped) (err error)
  295. // This function returns 1 byte BOOLEAN rather than the 4 byte BOOL.
  296. //sys CreateSymbolicLink(symlinkfilename *uint16, targetfilename *uint16, flags uint32) (err error) [failretval&0xff==0] = CreateSymbolicLinkW
  297. //sys CreateHardLink(filename *uint16, existingfilename *uint16, reserved uintptr) (err error) [failretval&0xff==0] = CreateHardLinkW
  298. //sys GetCurrentThreadId() (id uint32)
  299. //sys CreateEvent(eventAttrs *SecurityAttributes, manualReset uint32, initialState uint32, name *uint16) (handle Handle, err error) [failretval == 0 || e1 == ERROR_ALREADY_EXISTS] = kernel32.CreateEventW
  300. //sys CreateEventEx(eventAttrs *SecurityAttributes, name *uint16, flags uint32, desiredAccess uint32) (handle Handle, err error) [failretval == 0 || e1 == ERROR_ALREADY_EXISTS] = kernel32.CreateEventExW
  301. //sys OpenEvent(desiredAccess uint32, inheritHandle bool, name *uint16) (handle Handle, err error) = kernel32.OpenEventW
  302. //sys SetEvent(event Handle) (err error) = kernel32.SetEvent
  303. //sys ResetEvent(event Handle) (err error) = kernel32.ResetEvent
  304. //sys PulseEvent(event Handle) (err error) = kernel32.PulseEvent
  305. //sys CreateMutex(mutexAttrs *SecurityAttributes, initialOwner bool, name *uint16) (handle Handle, err error) [failretval == 0 || e1 == ERROR_ALREADY_EXISTS] = kernel32.CreateMutexW
  306. //sys CreateMutexEx(mutexAttrs *SecurityAttributes, name *uint16, flags uint32, desiredAccess uint32) (handle Handle, err error) [failretval == 0 || e1 == ERROR_ALREADY_EXISTS] = kernel32.CreateMutexExW
  307. //sys OpenMutex(desiredAccess uint32, inheritHandle bool, name *uint16) (handle Handle, err error) = kernel32.OpenMutexW
  308. //sys ReleaseMutex(mutex Handle) (err error) = kernel32.ReleaseMutex
  309. //sys SleepEx(milliseconds uint32, alertable bool) (ret uint32) = kernel32.SleepEx
  310. //sys CreateJobObject(jobAttr *SecurityAttributes, name *uint16) (handle Handle, err error) = kernel32.CreateJobObjectW
  311. //sys AssignProcessToJobObject(job Handle, process Handle) (err error) = kernel32.AssignProcessToJobObject
  312. //sys TerminateJobObject(job Handle, exitCode uint32) (err error) = kernel32.TerminateJobObject
  313. //sys SetErrorMode(mode uint32) (ret uint32) = kernel32.SetErrorMode
  314. //sys ResumeThread(thread Handle) (ret uint32, err error) [failretval==0xffffffff] = kernel32.ResumeThread
  315. //sys SetPriorityClass(process Handle, priorityClass uint32) (err error) = kernel32.SetPriorityClass
  316. //sys GetPriorityClass(process Handle) (ret uint32, err error) = kernel32.GetPriorityClass
  317. //sys QueryInformationJobObject(job Handle, JobObjectInformationClass int32, JobObjectInformation uintptr, JobObjectInformationLength uint32, retlen *uint32) (err error) = kernel32.QueryInformationJobObject
  318. //sys SetInformationJobObject(job Handle, JobObjectInformationClass uint32, JobObjectInformation uintptr, JobObjectInformationLength uint32) (ret int, err error)
  319. //sys GenerateConsoleCtrlEvent(ctrlEvent uint32, processGroupID uint32) (err error)
  320. //sys GetProcessId(process Handle) (id uint32, err error)
  321. //sys QueryFullProcessImageName(proc Handle, flags uint32, exeName *uint16, size *uint32) (err error) = kernel32.QueryFullProcessImageNameW
  322. //sys OpenThread(desiredAccess uint32, inheritHandle bool, threadId uint32) (handle Handle, err error)
  323. //sys SetProcessPriorityBoost(process Handle, disable bool) (err error) = kernel32.SetProcessPriorityBoost
  324. //sys GetProcessWorkingSetSizeEx(hProcess Handle, lpMinimumWorkingSetSize *uintptr, lpMaximumWorkingSetSize *uintptr, flags *uint32)
  325. //sys SetProcessWorkingSetSizeEx(hProcess Handle, dwMinimumWorkingSetSize uintptr, dwMaximumWorkingSetSize uintptr, flags uint32) (err error)
  326. //sys GetCommTimeouts(handle Handle, timeouts *CommTimeouts) (err error)
  327. //sys SetCommTimeouts(handle Handle, timeouts *CommTimeouts) (err error)
  328. //sys GetActiveProcessorCount(groupNumber uint16) (ret uint32)
  329. //sys GetMaximumProcessorCount(groupNumber uint16) (ret uint32)
  330. //sys EnumWindows(enumFunc uintptr, param unsafe.Pointer) (err error) = user32.EnumWindows
  331. //sys EnumChildWindows(hwnd HWND, enumFunc uintptr, param unsafe.Pointer) = user32.EnumChildWindows
  332. //sys GetClassName(hwnd HWND, className *uint16, maxCount int32) (copied int32, err error) = user32.GetClassNameW
  333. //sys GetDesktopWindow() (hwnd HWND) = user32.GetDesktopWindow
  334. //sys GetForegroundWindow() (hwnd HWND) = user32.GetForegroundWindow
  335. //sys IsWindow(hwnd HWND) (isWindow bool) = user32.IsWindow
  336. //sys IsWindowUnicode(hwnd HWND) (isUnicode bool) = user32.IsWindowUnicode
  337. //sys IsWindowVisible(hwnd HWND) (isVisible bool) = user32.IsWindowVisible
  338. //sys GetGUIThreadInfo(thread uint32, info *GUIThreadInfo) (err error) = user32.GetGUIThreadInfo
  339. //sys GetLargePageMinimum() (size uintptr)
  340. // Volume Management Functions
  341. //sys DefineDosDevice(flags uint32, deviceName *uint16, targetPath *uint16) (err error) = DefineDosDeviceW
  342. //sys DeleteVolumeMountPoint(volumeMountPoint *uint16) (err error) = DeleteVolumeMountPointW
  343. //sys FindFirstVolume(volumeName *uint16, bufferLength uint32) (handle Handle, err error) [failretval==InvalidHandle] = FindFirstVolumeW
  344. //sys FindFirstVolumeMountPoint(rootPathName *uint16, volumeMountPoint *uint16, bufferLength uint32) (handle Handle, err error) [failretval==InvalidHandle] = FindFirstVolumeMountPointW
  345. //sys FindNextVolume(findVolume Handle, volumeName *uint16, bufferLength uint32) (err error) = FindNextVolumeW
  346. //sys FindNextVolumeMountPoint(findVolumeMountPoint Handle, volumeMountPoint *uint16, bufferLength uint32) (err error) = FindNextVolumeMountPointW
  347. //sys FindVolumeClose(findVolume Handle) (err error)
  348. //sys FindVolumeMountPointClose(findVolumeMountPoint Handle) (err error)
  349. //sys GetDiskFreeSpaceEx(directoryName *uint16, freeBytesAvailableToCaller *uint64, totalNumberOfBytes *uint64, totalNumberOfFreeBytes *uint64) (err error) = GetDiskFreeSpaceExW
  350. //sys GetDriveType(rootPathName *uint16) (driveType uint32) = GetDriveTypeW
  351. //sys GetLogicalDrives() (drivesBitMask uint32, err error) [failretval==0]
  352. //sys GetLogicalDriveStrings(bufferLength uint32, buffer *uint16) (n uint32, err error) [failretval==0] = GetLogicalDriveStringsW
  353. //sys GetVolumeInformation(rootPathName *uint16, volumeNameBuffer *uint16, volumeNameSize uint32, volumeNameSerialNumber *uint32, maximumComponentLength *uint32, fileSystemFlags *uint32, fileSystemNameBuffer *uint16, fileSystemNameSize uint32) (err error) = GetVolumeInformationW
  354. //sys GetVolumeInformationByHandle(file Handle, volumeNameBuffer *uint16, volumeNameSize uint32, volumeNameSerialNumber *uint32, maximumComponentLength *uint32, fileSystemFlags *uint32, fileSystemNameBuffer *uint16, fileSystemNameSize uint32) (err error) = GetVolumeInformationByHandleW
  355. //sys GetVolumeNameForVolumeMountPoint(volumeMountPoint *uint16, volumeName *uint16, bufferlength uint32) (err error) = GetVolumeNameForVolumeMountPointW
  356. //sys GetVolumePathName(fileName *uint16, volumePathName *uint16, bufferLength uint32) (err error) = GetVolumePathNameW
  357. //sys GetVolumePathNamesForVolumeName(volumeName *uint16, volumePathNames *uint16, bufferLength uint32, returnLength *uint32) (err error) = GetVolumePathNamesForVolumeNameW
  358. //sys QueryDosDevice(deviceName *uint16, targetPath *uint16, max uint32) (n uint32, err error) [failretval==0] = QueryDosDeviceW
  359. //sys SetVolumeLabel(rootPathName *uint16, volumeName *uint16) (err error) = SetVolumeLabelW
  360. //sys SetVolumeMountPoint(volumeMountPoint *uint16, volumeName *uint16) (err error) = SetVolumeMountPointW
  361. //sys InitiateSystemShutdownEx(machineName *uint16, message *uint16, timeout uint32, forceAppsClosed bool, rebootAfterShutdown bool, reason uint32) (err error) = advapi32.InitiateSystemShutdownExW
  362. //sys SetProcessShutdownParameters(level uint32, flags uint32) (err error) = kernel32.SetProcessShutdownParameters
  363. //sys GetProcessShutdownParameters(level *uint32, flags *uint32) (err error) = kernel32.GetProcessShutdownParameters
  364. //sys clsidFromString(lpsz *uint16, pclsid *GUID) (ret error) = ole32.CLSIDFromString
  365. //sys stringFromGUID2(rguid *GUID, lpsz *uint16, cchMax int32) (chars int32) = ole32.StringFromGUID2
  366. //sys coCreateGuid(pguid *GUID) (ret error) = ole32.CoCreateGuid
  367. //sys CoTaskMemFree(address unsafe.Pointer) = ole32.CoTaskMemFree
  368. //sys CoInitializeEx(reserved uintptr, coInit uint32) (ret error) = ole32.CoInitializeEx
  369. //sys CoUninitialize() = ole32.CoUninitialize
  370. //sys CoGetObject(name *uint16, bindOpts *BIND_OPTS3, guid *GUID, functionTable **uintptr) (ret error) = ole32.CoGetObject
  371. //sys getProcessPreferredUILanguages(flags uint32, numLanguages *uint32, buf *uint16, bufSize *uint32) (err error) = kernel32.GetProcessPreferredUILanguages
  372. //sys getThreadPreferredUILanguages(flags uint32, numLanguages *uint32, buf *uint16, bufSize *uint32) (err error) = kernel32.GetThreadPreferredUILanguages
  373. //sys getUserPreferredUILanguages(flags uint32, numLanguages *uint32, buf *uint16, bufSize *uint32) (err error) = kernel32.GetUserPreferredUILanguages
  374. //sys getSystemPreferredUILanguages(flags uint32, numLanguages *uint32, buf *uint16, bufSize *uint32) (err error) = kernel32.GetSystemPreferredUILanguages
  375. //sys findResource(module Handle, name uintptr, resType uintptr) (resInfo Handle, err error) = kernel32.FindResourceW
  376. //sys SizeofResource(module Handle, resInfo Handle) (size uint32, err error) = kernel32.SizeofResource
  377. //sys LoadResource(module Handle, resInfo Handle) (resData Handle, err error) = kernel32.LoadResource
  378. //sys LockResource(resData Handle) (addr uintptr, err error) = kernel32.LockResource
  379. // Version APIs
  380. //sys GetFileVersionInfoSize(filename string, zeroHandle *Handle) (bufSize uint32, err error) = version.GetFileVersionInfoSizeW
  381. //sys GetFileVersionInfo(filename string, handle uint32, bufSize uint32, buffer unsafe.Pointer) (err error) = version.GetFileVersionInfoW
  382. //sys VerQueryValue(block unsafe.Pointer, subBlock string, pointerToBufferPointer unsafe.Pointer, bufSize *uint32) (err error) = version.VerQueryValueW
  383. // Process Status API (PSAPI)
  384. //sys enumProcesses(processIds *uint32, nSize uint32, bytesReturned *uint32) (err error) = psapi.EnumProcesses
  385. //sys EnumProcessModules(process Handle, module *Handle, cb uint32, cbNeeded *uint32) (err error) = psapi.EnumProcessModules
  386. //sys EnumProcessModulesEx(process Handle, module *Handle, cb uint32, cbNeeded *uint32, filterFlag uint32) (err error) = psapi.EnumProcessModulesEx
  387. //sys GetModuleInformation(process Handle, module Handle, modinfo *ModuleInfo, cb uint32) (err error) = psapi.GetModuleInformation
  388. //sys GetModuleFileNameEx(process Handle, module Handle, filename *uint16, size uint32) (err error) = psapi.GetModuleFileNameExW
  389. //sys GetModuleBaseName(process Handle, module Handle, baseName *uint16, size uint32) (err error) = psapi.GetModuleBaseNameW
  390. //sys QueryWorkingSetEx(process Handle, pv uintptr, cb uint32) (err error) = psapi.QueryWorkingSetEx
  391. // NT Native APIs
  392. //sys rtlNtStatusToDosErrorNoTeb(ntstatus NTStatus) (ret syscall.Errno) = ntdll.RtlNtStatusToDosErrorNoTeb
  393. //sys rtlGetVersion(info *OsVersionInfoEx) (ntstatus error) = ntdll.RtlGetVersion
  394. //sys rtlGetNtVersionNumbers(majorVersion *uint32, minorVersion *uint32, buildNumber *uint32) = ntdll.RtlGetNtVersionNumbers
  395. //sys RtlGetCurrentPeb() (peb *PEB) = ntdll.RtlGetCurrentPeb
  396. //sys RtlInitUnicodeString(destinationString *NTUnicodeString, sourceString *uint16) = ntdll.RtlInitUnicodeString
  397. //sys RtlInitString(destinationString *NTString, sourceString *byte) = ntdll.RtlInitString
  398. //sys NtCreateFile(handle *Handle, access uint32, oa *OBJECT_ATTRIBUTES, iosb *IO_STATUS_BLOCK, allocationSize *int64, attributes uint32, share uint32, disposition uint32, options uint32, eabuffer uintptr, ealength uint32) (ntstatus error) = ntdll.NtCreateFile
  399. //sys NtCreateNamedPipeFile(pipe *Handle, access uint32, oa *OBJECT_ATTRIBUTES, iosb *IO_STATUS_BLOCK, share uint32, disposition uint32, options uint32, typ uint32, readMode uint32, completionMode uint32, maxInstances uint32, inboundQuota uint32, outputQuota uint32, timeout *int64) (ntstatus error) = ntdll.NtCreateNamedPipeFile
  400. //sys NtSetInformationFile(handle Handle, iosb *IO_STATUS_BLOCK, inBuffer *byte, inBufferLen uint32, class uint32) (ntstatus error) = ntdll.NtSetInformationFile
  401. //sys RtlDosPathNameToNtPathName(dosName *uint16, ntName *NTUnicodeString, ntFileNamePart *uint16, relativeName *RTL_RELATIVE_NAME) (ntstatus error) = ntdll.RtlDosPathNameToNtPathName_U_WithStatus
  402. //sys RtlDosPathNameToRelativeNtPathName(dosName *uint16, ntName *NTUnicodeString, ntFileNamePart *uint16, relativeName *RTL_RELATIVE_NAME) (ntstatus error) = ntdll.RtlDosPathNameToRelativeNtPathName_U_WithStatus
  403. //sys RtlDefaultNpAcl(acl **ACL) (ntstatus error) = ntdll.RtlDefaultNpAcl
  404. //sys NtQueryInformationProcess(proc Handle, procInfoClass int32, procInfo unsafe.Pointer, procInfoLen uint32, retLen *uint32) (ntstatus error) = ntdll.NtQueryInformationProcess
  405. //sys NtSetInformationProcess(proc Handle, procInfoClass int32, procInfo unsafe.Pointer, procInfoLen uint32) (ntstatus error) = ntdll.NtSetInformationProcess
  406. //sys NtQuerySystemInformation(sysInfoClass int32, sysInfo unsafe.Pointer, sysInfoLen uint32, retLen *uint32) (ntstatus error) = ntdll.NtQuerySystemInformation
  407. //sys NtSetSystemInformation(sysInfoClass int32, sysInfo unsafe.Pointer, sysInfoLen uint32) (ntstatus error) = ntdll.NtSetSystemInformation
  408. //sys RtlAddFunctionTable(functionTable *RUNTIME_FUNCTION, entryCount uint32, baseAddress uintptr) (ret bool) = ntdll.RtlAddFunctionTable
  409. //sys RtlDeleteFunctionTable(functionTable *RUNTIME_FUNCTION) (ret bool) = ntdll.RtlDeleteFunctionTable
  410. // Desktop Window Manager API (Dwmapi)
  411. //sys DwmGetWindowAttribute(hwnd HWND, attribute uint32, value unsafe.Pointer, size uint32) (ret error) = dwmapi.DwmGetWindowAttribute
  412. //sys DwmSetWindowAttribute(hwnd HWND, attribute uint32, value unsafe.Pointer, size uint32) (ret error) = dwmapi.DwmSetWindowAttribute
  413. // Windows Multimedia API
  414. //sys TimeBeginPeriod (period uint32) (err error) [failretval != 0] = winmm.timeBeginPeriod
  415. //sys TimeEndPeriod (period uint32) (err error) [failretval != 0] = winmm.timeEndPeriod
  416. // syscall interface implementation for other packages
  417. // GetCurrentProcess returns the handle for the current process.
  418. // It is a pseudo handle that does not need to be closed.
  419. // The returned error is always nil.
  420. //
  421. // Deprecated: use CurrentProcess for the same Handle without the nil
  422. // error.
  423. func GetCurrentProcess() (Handle, error) {
  424. return CurrentProcess(), nil
  425. }
  426. // CurrentProcess returns the handle for the current process.
  427. // It is a pseudo handle that does not need to be closed.
  428. func CurrentProcess() Handle { return Handle(^uintptr(1 - 1)) }
  429. // GetCurrentThread returns the handle for the current thread.
  430. // It is a pseudo handle that does not need to be closed.
  431. // The returned error is always nil.
  432. //
  433. // Deprecated: use CurrentThread for the same Handle without the nil
  434. // error.
  435. func GetCurrentThread() (Handle, error) {
  436. return CurrentThread(), nil
  437. }
  438. // CurrentThread returns the handle for the current thread.
  439. // It is a pseudo handle that does not need to be closed.
  440. func CurrentThread() Handle { return Handle(^uintptr(2 - 1)) }
  441. // GetProcAddressByOrdinal retrieves the address of the exported
  442. // function from module by ordinal.
  443. func GetProcAddressByOrdinal(module Handle, ordinal uintptr) (proc uintptr, err error) {
  444. r0, _, e1 := syscall.Syscall(procGetProcAddress.Addr(), 2, uintptr(module), ordinal, 0)
  445. proc = uintptr(r0)
  446. if proc == 0 {
  447. err = errnoErr(e1)
  448. }
  449. return
  450. }
  451. func Exit(code int) { ExitProcess(uint32(code)) }
  452. func makeInheritSa() *SecurityAttributes {
  453. var sa SecurityAttributes
  454. sa.Length = uint32(unsafe.Sizeof(sa))
  455. sa.InheritHandle = 1
  456. return &sa
  457. }
  458. func Open(path string, mode int, perm uint32) (fd Handle, err error) {
  459. if len(path) == 0 {
  460. return InvalidHandle, ERROR_FILE_NOT_FOUND
  461. }
  462. pathp, err := UTF16PtrFromString(path)
  463. if err != nil {
  464. return InvalidHandle, err
  465. }
  466. var access uint32
  467. switch mode & (O_RDONLY | O_WRONLY | O_RDWR) {
  468. case O_RDONLY:
  469. access = GENERIC_READ
  470. case O_WRONLY:
  471. access = GENERIC_WRITE
  472. case O_RDWR:
  473. access = GENERIC_READ | GENERIC_WRITE
  474. }
  475. if mode&O_CREAT != 0 {
  476. access |= GENERIC_WRITE
  477. }
  478. if mode&O_APPEND != 0 {
  479. access &^= GENERIC_WRITE
  480. access |= FILE_APPEND_DATA
  481. }
  482. sharemode := uint32(FILE_SHARE_READ | FILE_SHARE_WRITE)
  483. var sa *SecurityAttributes
  484. if mode&O_CLOEXEC == 0 {
  485. sa = makeInheritSa()
  486. }
  487. var createmode uint32
  488. switch {
  489. case mode&(O_CREAT|O_EXCL) == (O_CREAT | O_EXCL):
  490. createmode = CREATE_NEW
  491. case mode&(O_CREAT|O_TRUNC) == (O_CREAT | O_TRUNC):
  492. createmode = CREATE_ALWAYS
  493. case mode&O_CREAT == O_CREAT:
  494. createmode = OPEN_ALWAYS
  495. case mode&O_TRUNC == O_TRUNC:
  496. createmode = TRUNCATE_EXISTING
  497. default:
  498. createmode = OPEN_EXISTING
  499. }
  500. var attrs uint32 = FILE_ATTRIBUTE_NORMAL
  501. if perm&S_IWRITE == 0 {
  502. attrs = FILE_ATTRIBUTE_READONLY
  503. }
  504. h, e := CreateFile(pathp, access, sharemode, sa, createmode, attrs, 0)
  505. return h, e
  506. }
  507. func Read(fd Handle, p []byte) (n int, err error) {
  508. var done uint32
  509. e := ReadFile(fd, p, &done, nil)
  510. if e != nil {
  511. if e == ERROR_BROKEN_PIPE {
  512. // NOTE(brainman): work around ERROR_BROKEN_PIPE is returned on reading EOF from stdin
  513. return 0, nil
  514. }
  515. return 0, e
  516. }
  517. return int(done), nil
  518. }
  519. func Write(fd Handle, p []byte) (n int, err error) {
  520. if raceenabled {
  521. raceReleaseMerge(unsafe.Pointer(&ioSync))
  522. }
  523. var done uint32
  524. e := WriteFile(fd, p, &done, nil)
  525. if e != nil {
  526. return 0, e
  527. }
  528. return int(done), nil
  529. }
  530. func ReadFile(fd Handle, p []byte, done *uint32, overlapped *Overlapped) error {
  531. err := readFile(fd, p, done, overlapped)
  532. if raceenabled {
  533. if *done > 0 {
  534. raceWriteRange(unsafe.Pointer(&p[0]), int(*done))
  535. }
  536. raceAcquire(unsafe.Pointer(&ioSync))
  537. }
  538. return err
  539. }
  540. func WriteFile(fd Handle, p []byte, done *uint32, overlapped *Overlapped) error {
  541. if raceenabled {
  542. raceReleaseMerge(unsafe.Pointer(&ioSync))
  543. }
  544. err := writeFile(fd, p, done, overlapped)
  545. if raceenabled && *done > 0 {
  546. raceReadRange(unsafe.Pointer(&p[0]), int(*done))
  547. }
  548. return err
  549. }
  550. var ioSync int64
  551. func Seek(fd Handle, offset int64, whence int) (newoffset int64, err error) {
  552. var w uint32
  553. switch whence {
  554. case 0:
  555. w = FILE_BEGIN
  556. case 1:
  557. w = FILE_CURRENT
  558. case 2:
  559. w = FILE_END
  560. }
  561. hi := int32(offset >> 32)
  562. lo := int32(offset)
  563. // use GetFileType to check pipe, pipe can't do seek
  564. ft, _ := GetFileType(fd)
  565. if ft == FILE_TYPE_PIPE {
  566. return 0, syscall.EPIPE
  567. }
  568. rlo, e := SetFilePointer(fd, lo, &hi, w)
  569. if e != nil {
  570. return 0, e
  571. }
  572. return int64(hi)<<32 + int64(rlo), nil
  573. }
  574. func Close(fd Handle) (err error) {
  575. return CloseHandle(fd)
  576. }
  577. var (
  578. Stdin = getStdHandle(STD_INPUT_HANDLE)
  579. Stdout = getStdHandle(STD_OUTPUT_HANDLE)
  580. Stderr = getStdHandle(STD_ERROR_HANDLE)
  581. )
  582. func getStdHandle(stdhandle uint32) (fd Handle) {
  583. r, _ := GetStdHandle(stdhandle)
  584. return r
  585. }
  586. const ImplementsGetwd = true
  587. func Getwd() (wd string, err error) {
  588. b := make([]uint16, 300)
  589. n, e := GetCurrentDirectory(uint32(len(b)), &b[0])
  590. if e != nil {
  591. return "", e
  592. }
  593. return string(utf16.Decode(b[0:n])), nil
  594. }
  595. func Chdir(path string) (err error) {
  596. pathp, err := UTF16PtrFromString(path)
  597. if err != nil {
  598. return err
  599. }
  600. return SetCurrentDirectory(pathp)
  601. }
  602. func Mkdir(path string, mode uint32) (err error) {
  603. pathp, err := UTF16PtrFromString(path)
  604. if err != nil {
  605. return err
  606. }
  607. return CreateDirectory(pathp, nil)
  608. }
  609. func Rmdir(path string) (err error) {
  610. pathp, err := UTF16PtrFromString(path)
  611. if err != nil {
  612. return err
  613. }
  614. return RemoveDirectory(pathp)
  615. }
  616. func Unlink(path string) (err error) {
  617. pathp, err := UTF16PtrFromString(path)
  618. if err != nil {
  619. return err
  620. }
  621. return DeleteFile(pathp)
  622. }
  623. func Rename(oldpath, newpath string) (err error) {
  624. from, err := UTF16PtrFromString(oldpath)
  625. if err != nil {
  626. return err
  627. }
  628. to, err := UTF16PtrFromString(newpath)
  629. if err != nil {
  630. return err
  631. }
  632. return MoveFileEx(from, to, MOVEFILE_REPLACE_EXISTING)
  633. }
  634. func ComputerName() (name string, err error) {
  635. var n uint32 = MAX_COMPUTERNAME_LENGTH + 1
  636. b := make([]uint16, n)
  637. e := GetComputerName(&b[0], &n)
  638. if e != nil {
  639. return "", e
  640. }
  641. return string(utf16.Decode(b[0:n])), nil
  642. }
  643. func DurationSinceBoot() time.Duration {
  644. return time.Duration(getTickCount64()) * time.Millisecond
  645. }
  646. func Ftruncate(fd Handle, length int64) (err error) {
  647. curoffset, e := Seek(fd, 0, 1)
  648. if e != nil {
  649. return e
  650. }
  651. defer Seek(fd, curoffset, 0)
  652. _, e = Seek(fd, length, 0)
  653. if e != nil {
  654. return e
  655. }
  656. e = SetEndOfFile(fd)
  657. if e != nil {
  658. return e
  659. }
  660. return nil
  661. }
  662. func Gettimeofday(tv *Timeval) (err error) {
  663. var ft Filetime
  664. GetSystemTimeAsFileTime(&ft)
  665. *tv = NsecToTimeval(ft.Nanoseconds())
  666. return nil
  667. }
  668. func Pipe(p []Handle) (err error) {
  669. if len(p) != 2 {
  670. return syscall.EINVAL
  671. }
  672. var r, w Handle
  673. e := CreatePipe(&r, &w, makeInheritSa(), 0)
  674. if e != nil {
  675. return e
  676. }
  677. p[0] = r
  678. p[1] = w
  679. return nil
  680. }
  681. func Utimes(path string, tv []Timeval) (err error) {
  682. if len(tv) != 2 {
  683. return syscall.EINVAL
  684. }
  685. pathp, e := UTF16PtrFromString(path)
  686. if e != nil {
  687. return e
  688. }
  689. h, e := CreateFile(pathp,
  690. FILE_WRITE_ATTRIBUTES, FILE_SHARE_WRITE, nil,
  691. OPEN_EXISTING, FILE_FLAG_BACKUP_SEMANTICS, 0)
  692. if e != nil {
  693. return e
  694. }
  695. defer CloseHandle(h)
  696. a := NsecToFiletime(tv[0].Nanoseconds())
  697. w := NsecToFiletime(tv[1].Nanoseconds())
  698. return SetFileTime(h, nil, &a, &w)
  699. }
  700. func UtimesNano(path string, ts []Timespec) (err error) {
  701. if len(ts) != 2 {
  702. return syscall.EINVAL
  703. }
  704. pathp, e := UTF16PtrFromString(path)
  705. if e != nil {
  706. return e
  707. }
  708. h, e := CreateFile(pathp,
  709. FILE_WRITE_ATTRIBUTES, FILE_SHARE_WRITE, nil,
  710. OPEN_EXISTING, FILE_FLAG_BACKUP_SEMANTICS, 0)
  711. if e != nil {
  712. return e
  713. }
  714. defer CloseHandle(h)
  715. a := NsecToFiletime(TimespecToNsec(ts[0]))
  716. w := NsecToFiletime(TimespecToNsec(ts[1]))
  717. return SetFileTime(h, nil, &a, &w)
  718. }
  719. func Fsync(fd Handle) (err error) {
  720. return FlushFileBuffers(fd)
  721. }
  722. func Chmod(path string, mode uint32) (err error) {
  723. p, e := UTF16PtrFromString(path)
  724. if e != nil {
  725. return e
  726. }
  727. attrs, e := GetFileAttributes(p)
  728. if e != nil {
  729. return e
  730. }
  731. if mode&S_IWRITE != 0 {
  732. attrs &^= FILE_ATTRIBUTE_READONLY
  733. } else {
  734. attrs |= FILE_ATTRIBUTE_READONLY
  735. }
  736. return SetFileAttributes(p, attrs)
  737. }
  738. func LoadGetSystemTimePreciseAsFileTime() error {
  739. return procGetSystemTimePreciseAsFileTime.Find()
  740. }
  741. func LoadCancelIoEx() error {
  742. return procCancelIoEx.Find()
  743. }
  744. func LoadSetFileCompletionNotificationModes() error {
  745. return procSetFileCompletionNotificationModes.Find()
  746. }
  747. func WaitForMultipleObjects(handles []Handle, waitAll bool, waitMilliseconds uint32) (event uint32, err error) {
  748. // Every other win32 array API takes arguments as "pointer, count", except for this function. So we
  749. // can't declare it as a usual [] type, because mksyscall will use the opposite order. We therefore
  750. // trivially stub this ourselves.
  751. var handlePtr *Handle
  752. if len(handles) > 0 {
  753. handlePtr = &handles[0]
  754. }
  755. return waitForMultipleObjects(uint32(len(handles)), uintptr(unsafe.Pointer(handlePtr)), waitAll, waitMilliseconds)
  756. }
  757. // net api calls
  758. const socket_error = uintptr(^uint32(0))
  759. //sys WSAStartup(verreq uint32, data *WSAData) (sockerr error) = ws2_32.WSAStartup
  760. //sys WSACleanup() (err error) [failretval==socket_error] = ws2_32.WSACleanup
  761. //sys WSAIoctl(s Handle, iocc uint32, inbuf *byte, cbif uint32, outbuf *byte, cbob uint32, cbbr *uint32, overlapped *Overlapped, completionRoutine uintptr) (err error) [failretval==socket_error] = ws2_32.WSAIoctl
  762. //sys WSALookupServiceBegin(querySet *WSAQUERYSET, flags uint32, handle *Handle) (err error) [failretval==socket_error] = ws2_32.WSALookupServiceBeginW
  763. //sys WSALookupServiceNext(handle Handle, flags uint32, size *int32, querySet *WSAQUERYSET) (err error) [failretval==socket_error] = ws2_32.WSALookupServiceNextW
  764. //sys WSALookupServiceEnd(handle Handle) (err error) [failretval==socket_error] = ws2_32.WSALookupServiceEnd
  765. //sys socket(af int32, typ int32, protocol int32) (handle Handle, err error) [failretval==InvalidHandle] = ws2_32.socket
  766. //sys sendto(s Handle, buf []byte, flags int32, to unsafe.Pointer, tolen int32) (err error) [failretval==socket_error] = ws2_32.sendto
  767. //sys recvfrom(s Handle, buf []byte, flags int32, from *RawSockaddrAny, fromlen *int32) (n int32, err error) [failretval==-1] = ws2_32.recvfrom
  768. //sys Setsockopt(s Handle, level int32, optname int32, optval *byte, optlen int32) (err error) [failretval==socket_error] = ws2_32.setsockopt
  769. //sys Getsockopt(s Handle, level int32, optname int32, optval *byte, optlen *int32) (err error) [failretval==socket_error] = ws2_32.getsockopt
  770. //sys bind(s Handle, name unsafe.Pointer, namelen int32) (err error) [failretval==socket_error] = ws2_32.bind
  771. //sys connect(s Handle, name unsafe.Pointer, namelen int32) (err error) [failretval==socket_error] = ws2_32.connect
  772. //sys getsockname(s Handle, rsa *RawSockaddrAny, addrlen *int32) (err error) [failretval==socket_error] = ws2_32.getsockname
  773. //sys getpeername(s Handle, rsa *RawSockaddrAny, addrlen *int32) (err error) [failretval==socket_error] = ws2_32.getpeername
  774. //sys listen(s Handle, backlog int32) (err error) [failretval==socket_error] = ws2_32.listen
  775. //sys shutdown(s Handle, how int32) (err error) [failretval==socket_error] = ws2_32.shutdown
  776. //sys Closesocket(s Handle) (err error) [failretval==socket_error] = ws2_32.closesocket
  777. //sys AcceptEx(ls Handle, as Handle, buf *byte, rxdatalen uint32, laddrlen uint32, raddrlen uint32, recvd *uint32, overlapped *Overlapped) (err error) = mswsock.AcceptEx
  778. //sys GetAcceptExSockaddrs(buf *byte, rxdatalen uint32, laddrlen uint32, raddrlen uint32, lrsa **RawSockaddrAny, lrsalen *int32, rrsa **RawSockaddrAny, rrsalen *int32) = mswsock.GetAcceptExSockaddrs
  779. //sys WSARecv(s Handle, bufs *WSABuf, bufcnt uint32, recvd *uint32, flags *uint32, overlapped *Overlapped, croutine *byte) (err error) [failretval==socket_error] = ws2_32.WSARecv
  780. //sys WSASend(s Handle, bufs *WSABuf, bufcnt uint32, sent *uint32, flags uint32, overlapped *Overlapped, croutine *byte) (err error) [failretval==socket_error] = ws2_32.WSASend
  781. //sys WSARecvFrom(s Handle, bufs *WSABuf, bufcnt uint32, recvd *uint32, flags *uint32, from *RawSockaddrAny, fromlen *int32, overlapped *Overlapped, croutine *byte) (err error) [failretval==socket_error] = ws2_32.WSARecvFrom
  782. //sys WSASendTo(s Handle, bufs *WSABuf, bufcnt uint32, sent *uint32, flags uint32, to *RawSockaddrAny, tolen int32, overlapped *Overlapped, croutine *byte) (err error) [failretval==socket_error] = ws2_32.WSASendTo
  783. //sys WSASocket(af int32, typ int32, protocol int32, protoInfo *WSAProtocolInfo, group uint32, flags uint32) (handle Handle, err error) [failretval==InvalidHandle] = ws2_32.WSASocketW
  784. //sys GetHostByName(name string) (h *Hostent, err error) [failretval==nil] = ws2_32.gethostbyname
  785. //sys GetServByName(name string, proto string) (s *Servent, err error) [failretval==nil] = ws2_32.getservbyname
  786. //sys Ntohs(netshort uint16) (u uint16) = ws2_32.ntohs
  787. //sys GetProtoByName(name string) (p *Protoent, err error) [failretval==nil] = ws2_32.getprotobyname
  788. //sys DnsQuery(name string, qtype uint16, options uint32, extra *byte, qrs **DNSRecord, pr *byte) (status error) = dnsapi.DnsQuery_W
  789. //sys DnsRecordListFree(rl *DNSRecord, freetype uint32) = dnsapi.DnsRecordListFree
  790. //sys DnsNameCompare(name1 *uint16, name2 *uint16) (same bool) = dnsapi.DnsNameCompare_W
  791. //sys GetAddrInfoW(nodename *uint16, servicename *uint16, hints *AddrinfoW, result **AddrinfoW) (sockerr error) = ws2_32.GetAddrInfoW
  792. //sys FreeAddrInfoW(addrinfo *AddrinfoW) = ws2_32.FreeAddrInfoW
  793. //sys GetIfEntry(pIfRow *MibIfRow) (errcode error) = iphlpapi.GetIfEntry
  794. //sys GetAdaptersInfo(ai *IpAdapterInfo, ol *uint32) (errcode error) = iphlpapi.GetAdaptersInfo
  795. //sys SetFileCompletionNotificationModes(handle Handle, flags uint8) (err error) = kernel32.SetFileCompletionNotificationModes
  796. //sys WSAEnumProtocols(protocols *int32, protocolBuffer *WSAProtocolInfo, bufferLength *uint32) (n int32, err error) [failretval==-1] = ws2_32.WSAEnumProtocolsW
  797. //sys WSAGetOverlappedResult(h Handle, o *Overlapped, bytes *uint32, wait bool, flags *uint32) (err error) = ws2_32.WSAGetOverlappedResult
  798. //sys GetAdaptersAddresses(family uint32, flags uint32, reserved uintptr, adapterAddresses *IpAdapterAddresses, sizePointer *uint32) (errcode error) = iphlpapi.GetAdaptersAddresses
  799. //sys GetACP() (acp uint32) = kernel32.GetACP
  800. //sys MultiByteToWideChar(codePage uint32, dwFlags uint32, str *byte, nstr int32, wchar *uint16, nwchar int32) (nwrite int32, err error) = kernel32.MultiByteToWideChar
  801. //sys getBestInterfaceEx(sockaddr unsafe.Pointer, pdwBestIfIndex *uint32) (errcode error) = iphlpapi.GetBestInterfaceEx
  802. // For testing: clients can set this flag to force
  803. // creation of IPv6 sockets to return EAFNOSUPPORT.
  804. var SocketDisableIPv6 bool
  805. type RawSockaddrInet4 struct {
  806. Family uint16
  807. Port uint16
  808. Addr [4]byte /* in_addr */
  809. Zero [8]uint8
  810. }
  811. type RawSockaddrInet6 struct {
  812. Family uint16
  813. Port uint16
  814. Flowinfo uint32
  815. Addr [16]byte /* in6_addr */
  816. Scope_id uint32
  817. }
  818. type RawSockaddr struct {
  819. Family uint16
  820. Data [14]int8
  821. }
  822. type RawSockaddrAny struct {
  823. Addr RawSockaddr
  824. Pad [100]int8
  825. }
  826. type Sockaddr interface {
  827. sockaddr() (ptr unsafe.Pointer, len int32, err error) // lowercase; only we can define Sockaddrs
  828. }
  829. type SockaddrInet4 struct {
  830. Port int
  831. Addr [4]byte
  832. raw RawSockaddrInet4
  833. }
  834. func (sa *SockaddrInet4) sockaddr() (unsafe.Pointer, int32, error) {
  835. if sa.Port < 0 || sa.Port > 0xFFFF {
  836. return nil, 0, syscall.EINVAL
  837. }
  838. sa.raw.Family = AF_INET
  839. p := (*[2]byte)(unsafe.Pointer(&sa.raw.Port))
  840. p[0] = byte(sa.Port >> 8)
  841. p[1] = byte(sa.Port)
  842. sa.raw.Addr = sa.Addr
  843. return unsafe.Pointer(&sa.raw), int32(unsafe.Sizeof(sa.raw)), nil
  844. }
  845. type SockaddrInet6 struct {
  846. Port int
  847. ZoneId uint32
  848. Addr [16]byte
  849. raw RawSockaddrInet6
  850. }
  851. func (sa *SockaddrInet6) sockaddr() (unsafe.Pointer, int32, error) {
  852. if sa.Port < 0 || sa.Port > 0xFFFF {
  853. return nil, 0, syscall.EINVAL
  854. }
  855. sa.raw.Family = AF_INET6
  856. p := (*[2]byte)(unsafe.Pointer(&sa.raw.Port))
  857. p[0] = byte(sa.Port >> 8)
  858. p[1] = byte(sa.Port)
  859. sa.raw.Scope_id = sa.ZoneId
  860. sa.raw.Addr = sa.Addr
  861. return unsafe.Pointer(&sa.raw), int32(unsafe.Sizeof(sa.raw)), nil
  862. }
  863. type RawSockaddrUnix struct {
  864. Family uint16
  865. Path [UNIX_PATH_MAX]int8
  866. }
  867. type SockaddrUnix struct {
  868. Name string
  869. raw RawSockaddrUnix
  870. }
  871. func (sa *SockaddrUnix) sockaddr() (unsafe.Pointer, int32, error) {
  872. name := sa.Name
  873. n := len(name)
  874. if n > len(sa.raw.Path) {
  875. return nil, 0, syscall.EINVAL
  876. }
  877. if n == len(sa.raw.Path) && name[0] != '@' {
  878. return nil, 0, syscall.EINVAL
  879. }
  880. sa.raw.Family = AF_UNIX
  881. for i := 0; i < n; i++ {
  882. sa.raw.Path[i] = int8(name[i])
  883. }
  884. // length is family (uint16), name, NUL.
  885. sl := int32(2)
  886. if n > 0 {
  887. sl += int32(n) + 1
  888. }
  889. if sa.raw.Path[0] == '@' || (sa.raw.Path[0] == 0 && sl > 3) {
  890. // Check sl > 3 so we don't change unnamed socket behavior.
  891. sa.raw.Path[0] = 0
  892. // Don't count trailing NUL for abstract address.
  893. sl--
  894. }
  895. return unsafe.Pointer(&sa.raw), sl, nil
  896. }
  897. type RawSockaddrBth struct {
  898. AddressFamily [2]byte
  899. BtAddr [8]byte
  900. ServiceClassId [16]byte
  901. Port [4]byte
  902. }
  903. type SockaddrBth struct {
  904. BtAddr uint64
  905. ServiceClassId GUID
  906. Port uint32
  907. raw RawSockaddrBth
  908. }
  909. func (sa *SockaddrBth) sockaddr() (unsafe.Pointer, int32, error) {
  910. family := AF_BTH
  911. sa.raw = RawSockaddrBth{
  912. AddressFamily: *(*[2]byte)(unsafe.Pointer(&family)),
  913. BtAddr: *(*[8]byte)(unsafe.Pointer(&sa.BtAddr)),
  914. Port: *(*[4]byte)(unsafe.Pointer(&sa.Port)),
  915. ServiceClassId: *(*[16]byte)(unsafe.Pointer(&sa.ServiceClassId)),
  916. }
  917. return unsafe.Pointer(&sa.raw), int32(unsafe.Sizeof(sa.raw)), nil
  918. }
  919. func (rsa *RawSockaddrAny) Sockaddr() (Sockaddr, error) {
  920. switch rsa.Addr.Family {
  921. case AF_UNIX:
  922. pp := (*RawSockaddrUnix)(unsafe.Pointer(rsa))
  923. sa := new(SockaddrUnix)
  924. if pp.Path[0] == 0 {
  925. // "Abstract" Unix domain socket.
  926. // Rewrite leading NUL as @ for textual display.
  927. // (This is the standard convention.)
  928. // Not friendly to overwrite in place,
  929. // but the callers below don't care.
  930. pp.Path[0] = '@'
  931. }
  932. // Assume path ends at NUL.
  933. // This is not technically the Linux semantics for
  934. // abstract Unix domain sockets--they are supposed
  935. // to be uninterpreted fixed-size binary blobs--but
  936. // everyone uses this convention.
  937. n := 0
  938. for n < len(pp.Path) && pp.Path[n] != 0 {
  939. n++
  940. }
  941. sa.Name = string(unsafe.Slice((*byte)(unsafe.Pointer(&pp.Path[0])), n))
  942. return sa, nil
  943. case AF_INET:
  944. pp := (*RawSockaddrInet4)(unsafe.Pointer(rsa))
  945. sa := new(SockaddrInet4)
  946. p := (*[2]byte)(unsafe.Pointer(&pp.Port))
  947. sa.Port = int(p[0])<<8 + int(p[1])
  948. sa.Addr = pp.Addr
  949. return sa, nil
  950. case AF_INET6:
  951. pp := (*RawSockaddrInet6)(unsafe.Pointer(rsa))
  952. sa := new(SockaddrInet6)
  953. p := (*[2]byte)(unsafe.Pointer(&pp.Port))
  954. sa.Port = int(p[0])<<8 + int(p[1])
  955. sa.ZoneId = pp.Scope_id
  956. sa.Addr = pp.Addr
  957. return sa, nil
  958. }
  959. return nil, syscall.EAFNOSUPPORT
  960. }
  961. func Socket(domain, typ, proto int) (fd Handle, err error) {
  962. if domain == AF_INET6 && SocketDisableIPv6 {
  963. return InvalidHandle, syscall.EAFNOSUPPORT
  964. }
  965. return socket(int32(domain), int32(typ), int32(proto))
  966. }
  967. func SetsockoptInt(fd Handle, level, opt int, value int) (err error) {
  968. v := int32(value)
  969. return Setsockopt(fd, int32(level), int32(opt), (*byte)(unsafe.Pointer(&v)), int32(unsafe.Sizeof(v)))
  970. }
  971. func Bind(fd Handle, sa Sockaddr) (err error) {
  972. ptr, n, err := sa.sockaddr()
  973. if err != nil {
  974. return err
  975. }
  976. return bind(fd, ptr, n)
  977. }
  978. func Connect(fd Handle, sa Sockaddr) (err error) {
  979. ptr, n, err := sa.sockaddr()
  980. if err != nil {
  981. return err
  982. }
  983. return connect(fd, ptr, n)
  984. }
  985. func GetBestInterfaceEx(sa Sockaddr, pdwBestIfIndex *uint32) (err error) {
  986. ptr, _, err := sa.sockaddr()
  987. if err != nil {
  988. return err
  989. }
  990. return getBestInterfaceEx(ptr, pdwBestIfIndex)
  991. }
  992. func Getsockname(fd Handle) (sa Sockaddr, err error) {
  993. var rsa RawSockaddrAny
  994. l := int32(unsafe.Sizeof(rsa))
  995. if err = getsockname(fd, &rsa, &l); err != nil {
  996. return
  997. }
  998. return rsa.Sockaddr()
  999. }
  1000. func Getpeername(fd Handle) (sa Sockaddr, err error) {
  1001. var rsa RawSockaddrAny
  1002. l := int32(unsafe.Sizeof(rsa))
  1003. if err = getpeername(fd, &rsa, &l); err != nil {
  1004. return
  1005. }
  1006. return rsa.Sockaddr()
  1007. }
  1008. func Listen(s Handle, n int) (err error) {
  1009. return listen(s, int32(n))
  1010. }
  1011. func Shutdown(fd Handle, how int) (err error) {
  1012. return shutdown(fd, int32(how))
  1013. }
  1014. func WSASendto(s Handle, bufs *WSABuf, bufcnt uint32, sent *uint32, flags uint32, to Sockaddr, overlapped *Overlapped, croutine *byte) (err error) {
  1015. var rsa unsafe.Pointer
  1016. var l int32
  1017. if to != nil {
  1018. rsa, l, err = to.sockaddr()
  1019. if err != nil {
  1020. return err
  1021. }
  1022. }
  1023. return WSASendTo(s, bufs, bufcnt, sent, flags, (*RawSockaddrAny)(unsafe.Pointer(rsa)), l, overlapped, croutine)
  1024. }
  1025. func LoadGetAddrInfo() error {
  1026. return procGetAddrInfoW.Find()
  1027. }
  1028. var connectExFunc struct {
  1029. once sync.Once
  1030. addr uintptr
  1031. err error
  1032. }
  1033. func LoadConnectEx() error {
  1034. connectExFunc.once.Do(func() {
  1035. var s Handle
  1036. s, connectExFunc.err = Socket(AF_INET, SOCK_STREAM, IPPROTO_TCP)
  1037. if connectExFunc.err != nil {
  1038. return
  1039. }
  1040. defer CloseHandle(s)
  1041. var n uint32
  1042. connectExFunc.err = WSAIoctl(s,
  1043. SIO_GET_EXTENSION_FUNCTION_POINTER,
  1044. (*byte)(unsafe.Pointer(&WSAID_CONNECTEX)),
  1045. uint32(unsafe.Sizeof(WSAID_CONNECTEX)),
  1046. (*byte)(unsafe.Pointer(&connectExFunc.addr)),
  1047. uint32(unsafe.Sizeof(connectExFunc.addr)),
  1048. &n, nil, 0)
  1049. })
  1050. return connectExFunc.err
  1051. }
  1052. func connectEx(s Handle, name unsafe.Pointer, namelen int32, sendBuf *byte, sendDataLen uint32, bytesSent *uint32, overlapped *Overlapped) (err error) {
  1053. r1, _, e1 := syscall.Syscall9(connectExFunc.addr, 7, uintptr(s), uintptr(name), uintptr(namelen), uintptr(unsafe.Pointer(sendBuf)), uintptr(sendDataLen), uintptr(unsafe.Pointer(bytesSent)), uintptr(unsafe.Pointer(overlapped)), 0, 0)
  1054. if r1 == 0 {
  1055. if e1 != 0 {
  1056. err = error(e1)
  1057. } else {
  1058. err = syscall.EINVAL
  1059. }
  1060. }
  1061. return
  1062. }
  1063. func ConnectEx(fd Handle, sa Sockaddr, sendBuf *byte, sendDataLen uint32, bytesSent *uint32, overlapped *Overlapped) error {
  1064. err := LoadConnectEx()
  1065. if err != nil {
  1066. return errorspkg.New("failed to find ConnectEx: " + err.Error())
  1067. }
  1068. ptr, n, err := sa.sockaddr()
  1069. if err != nil {
  1070. return err
  1071. }
  1072. return connectEx(fd, ptr, n, sendBuf, sendDataLen, bytesSent, overlapped)
  1073. }
  1074. var sendRecvMsgFunc struct {
  1075. once sync.Once
  1076. sendAddr uintptr
  1077. recvAddr uintptr
  1078. err error
  1079. }
  1080. func loadWSASendRecvMsg() error {
  1081. sendRecvMsgFunc.once.Do(func() {
  1082. var s Handle
  1083. s, sendRecvMsgFunc.err = Socket(AF_INET, SOCK_DGRAM, IPPROTO_UDP)
  1084. if sendRecvMsgFunc.err != nil {
  1085. return
  1086. }
  1087. defer CloseHandle(s)
  1088. var n uint32
  1089. sendRecvMsgFunc.err = WSAIoctl(s,
  1090. SIO_GET_EXTENSION_FUNCTION_POINTER,
  1091. (*byte)(unsafe.Pointer(&WSAID_WSARECVMSG)),
  1092. uint32(unsafe.Sizeof(WSAID_WSARECVMSG)),
  1093. (*byte)(unsafe.Pointer(&sendRecvMsgFunc.recvAddr)),
  1094. uint32(unsafe.Sizeof(sendRecvMsgFunc.recvAddr)),
  1095. &n, nil, 0)
  1096. if sendRecvMsgFunc.err != nil {
  1097. return
  1098. }
  1099. sendRecvMsgFunc.err = WSAIoctl(s,
  1100. SIO_GET_EXTENSION_FUNCTION_POINTER,
  1101. (*byte)(unsafe.Pointer(&WSAID_WSASENDMSG)),
  1102. uint32(unsafe.Sizeof(WSAID_WSASENDMSG)),
  1103. (*byte)(unsafe.Pointer(&sendRecvMsgFunc.sendAddr)),
  1104. uint32(unsafe.Sizeof(sendRecvMsgFunc.sendAddr)),
  1105. &n, nil, 0)
  1106. })
  1107. return sendRecvMsgFunc.err
  1108. }
  1109. func WSASendMsg(fd Handle, msg *WSAMsg, flags uint32, bytesSent *uint32, overlapped *Overlapped, croutine *byte) error {
  1110. err := loadWSASendRecvMsg()
  1111. if err != nil {
  1112. return err
  1113. }
  1114. r1, _, e1 := syscall.Syscall6(sendRecvMsgFunc.sendAddr, 6, uintptr(fd), uintptr(unsafe.Pointer(msg)), uintptr(flags), uintptr(unsafe.Pointer(bytesSent)), uintptr(unsafe.Pointer(overlapped)), uintptr(unsafe.Pointer(croutine)))
  1115. if r1 == socket_error {
  1116. err = errnoErr(e1)
  1117. }
  1118. return err
  1119. }
  1120. func WSARecvMsg(fd Handle, msg *WSAMsg, bytesReceived *uint32, overlapped *Overlapped, croutine *byte) error {
  1121. err := loadWSASendRecvMsg()
  1122. if err != nil {
  1123. return err
  1124. }
  1125. r1, _, e1 := syscall.Syscall6(sendRecvMsgFunc.recvAddr, 5, uintptr(fd), uintptr(unsafe.Pointer(msg)), uintptr(unsafe.Pointer(bytesReceived)), uintptr(unsafe.Pointer(overlapped)), uintptr(unsafe.Pointer(croutine)), 0)
  1126. if r1 == socket_error {
  1127. err = errnoErr(e1)
  1128. }
  1129. return err
  1130. }
  1131. // Invented structures to support what package os expects.
  1132. type Rusage struct {
  1133. CreationTime Filetime
  1134. ExitTime Filetime
  1135. KernelTime Filetime
  1136. UserTime Filetime
  1137. }
  1138. type WaitStatus struct {
  1139. ExitCode uint32
  1140. }
  1141. func (w WaitStatus) Exited() bool { return true }
  1142. func (w WaitStatus) ExitStatus() int { return int(w.ExitCode) }
  1143. func (w WaitStatus) Signal() Signal { return -1 }
  1144. func (w WaitStatus) CoreDump() bool { return false }
  1145. func (w WaitStatus) Stopped() bool { return false }
  1146. func (w WaitStatus) Continued() bool { return false }
  1147. func (w WaitStatus) StopSignal() Signal { return -1 }
  1148. func (w WaitStatus) Signaled() bool { return false }
  1149. func (w WaitStatus) TrapCause() int { return -1 }
  1150. // Timespec is an invented structure on Windows, but here for
  1151. // consistency with the corresponding package for other operating systems.
  1152. type Timespec struct {
  1153. Sec int64
  1154. Nsec int64
  1155. }
  1156. func TimespecToNsec(ts Timespec) int64 { return int64(ts.Sec)*1e9 + int64(ts.Nsec) }
  1157. func NsecToTimespec(nsec int64) (ts Timespec) {
  1158. ts.Sec = nsec / 1e9
  1159. ts.Nsec = nsec % 1e9
  1160. return
  1161. }
  1162. // TODO(brainman): fix all needed for net
  1163. func Accept(fd Handle) (nfd Handle, sa Sockaddr, err error) { return 0, nil, syscall.EWINDOWS }
  1164. func Recvfrom(fd Handle, p []byte, flags int) (n int, from Sockaddr, err error) {
  1165. var rsa RawSockaddrAny
  1166. l := int32(unsafe.Sizeof(rsa))
  1167. n32, err := recvfrom(fd, p, int32(flags), &rsa, &l)
  1168. n = int(n32)
  1169. if err != nil {
  1170. return
  1171. }
  1172. from, err = rsa.Sockaddr()
  1173. return
  1174. }
  1175. func Sendto(fd Handle, p []byte, flags int, to Sockaddr) (err error) {
  1176. ptr, l, err := to.sockaddr()
  1177. if err != nil {
  1178. return err
  1179. }
  1180. return sendto(fd, p, int32(flags), ptr, l)
  1181. }
  1182. func SetsockoptTimeval(fd Handle, level, opt int, tv *Timeval) (err error) { return syscall.EWINDOWS }
  1183. // The Linger struct is wrong but we only noticed after Go 1.
  1184. // sysLinger is the real system call structure.
  1185. // BUG(brainman): The definition of Linger is not appropriate for direct use
  1186. // with Setsockopt and Getsockopt.
  1187. // Use SetsockoptLinger instead.
  1188. type Linger struct {
  1189. Onoff int32
  1190. Linger int32
  1191. }
  1192. type sysLinger struct {
  1193. Onoff uint16
  1194. Linger uint16
  1195. }
  1196. type IPMreq struct {
  1197. Multiaddr [4]byte /* in_addr */
  1198. Interface [4]byte /* in_addr */
  1199. }
  1200. type IPv6Mreq struct {
  1201. Multiaddr [16]byte /* in6_addr */
  1202. Interface uint32
  1203. }
  1204. func GetsockoptInt(fd Handle, level, opt int) (int, error) {
  1205. v := int32(0)
  1206. l := int32(unsafe.Sizeof(v))
  1207. err := Getsockopt(fd, int32(level), int32(opt), (*byte)(unsafe.Pointer(&v)), &l)
  1208. return int(v), err
  1209. }
  1210. func SetsockoptLinger(fd Handle, level, opt int, l *Linger) (err error) {
  1211. sys := sysLinger{Onoff: uint16(l.Onoff), Linger: uint16(l.Linger)}
  1212. return Setsockopt(fd, int32(level), int32(opt), (*byte)(unsafe.Pointer(&sys)), int32(unsafe.Sizeof(sys)))
  1213. }
  1214. func SetsockoptInet4Addr(fd Handle, level, opt int, value [4]byte) (err error) {
  1215. return Setsockopt(fd, int32(level), int32(opt), (*byte)(unsafe.Pointer(&value[0])), 4)
  1216. }
  1217. func SetsockoptIPMreq(fd Handle, level, opt int, mreq *IPMreq) (err error) {
  1218. return Setsockopt(fd, int32(level), int32(opt), (*byte)(unsafe.Pointer(mreq)), int32(unsafe.Sizeof(*mreq)))
  1219. }
  1220. func SetsockoptIPv6Mreq(fd Handle, level, opt int, mreq *IPv6Mreq) (err error) {
  1221. return syscall.EWINDOWS
  1222. }
  1223. func EnumProcesses(processIds []uint32, bytesReturned *uint32) error {
  1224. // EnumProcesses syscall expects the size parameter to be in bytes, but the code generated with mksyscall uses
  1225. // the length of the processIds slice instead. Hence, this wrapper function is added to fix the discrepancy.
  1226. var p *uint32
  1227. if len(processIds) > 0 {
  1228. p = &processIds[0]
  1229. }
  1230. size := uint32(len(processIds) * 4)
  1231. return enumProcesses(p, size, bytesReturned)
  1232. }
  1233. func Getpid() (pid int) { return int(GetCurrentProcessId()) }
  1234. func FindFirstFile(name *uint16, data *Win32finddata) (handle Handle, err error) {
  1235. // NOTE(rsc): The Win32finddata struct is wrong for the system call:
  1236. // the two paths are each one uint16 short. Use the correct struct,
  1237. // a win32finddata1, and then copy the results out.
  1238. // There is no loss of expressivity here, because the final
  1239. // uint16, if it is used, is supposed to be a NUL, and Go doesn't need that.
  1240. // For Go 1.1, we might avoid the allocation of win32finddata1 here
  1241. // by adding a final Bug [2]uint16 field to the struct and then
  1242. // adjusting the fields in the result directly.
  1243. var data1 win32finddata1
  1244. handle, err = findFirstFile1(name, &data1)
  1245. if err == nil {
  1246. copyFindData(data, &data1)
  1247. }
  1248. return
  1249. }
  1250. func FindNextFile(handle Handle, data *Win32finddata) (err error) {
  1251. var data1 win32finddata1
  1252. err = findNextFile1(handle, &data1)
  1253. if err == nil {
  1254. copyFindData(data, &data1)
  1255. }
  1256. return
  1257. }
  1258. func getProcessEntry(pid int) (*ProcessEntry32, error) {
  1259. snapshot, err := CreateToolhelp32Snapshot(TH32CS_SNAPPROCESS, 0)
  1260. if err != nil {
  1261. return nil, err
  1262. }
  1263. defer CloseHandle(snapshot)
  1264. var procEntry ProcessEntry32
  1265. procEntry.Size = uint32(unsafe.Sizeof(procEntry))
  1266. if err = Process32First(snapshot, &procEntry); err != nil {
  1267. return nil, err
  1268. }
  1269. for {
  1270. if procEntry.ProcessID == uint32(pid) {
  1271. return &procEntry, nil
  1272. }
  1273. err = Process32Next(snapshot, &procEntry)
  1274. if err != nil {
  1275. return nil, err
  1276. }
  1277. }
  1278. }
  1279. func Getppid() (ppid int) {
  1280. pe, err := getProcessEntry(Getpid())
  1281. if err != nil {
  1282. return -1
  1283. }
  1284. return int(pe.ParentProcessID)
  1285. }
  1286. // TODO(brainman): fix all needed for os
  1287. func Fchdir(fd Handle) (err error) { return syscall.EWINDOWS }
  1288. func Link(oldpath, newpath string) (err error) { return syscall.EWINDOWS }
  1289. func Symlink(path, link string) (err error) { return syscall.EWINDOWS }
  1290. func Fchmod(fd Handle, mode uint32) (err error) { return syscall.EWINDOWS }
  1291. func Chown(path string, uid int, gid int) (err error) { return syscall.EWINDOWS }
  1292. func Lchown(path string, uid int, gid int) (err error) { return syscall.EWINDOWS }
  1293. func Fchown(fd Handle, uid int, gid int) (err error) { return syscall.EWINDOWS }
  1294. func Getuid() (uid int) { return -1 }
  1295. func Geteuid() (euid int) { return -1 }
  1296. func Getgid() (gid int) { return -1 }
  1297. func Getegid() (egid int) { return -1 }
  1298. func Getgroups() (gids []int, err error) { return nil, syscall.EWINDOWS }
  1299. type Signal int
  1300. func (s Signal) Signal() {}
  1301. func (s Signal) String() string {
  1302. if 0 <= s && int(s) < len(signals) {
  1303. str := signals[s]
  1304. if str != "" {
  1305. return str
  1306. }
  1307. }
  1308. return "signal " + itoa(int(s))
  1309. }
  1310. func LoadCreateSymbolicLink() error {
  1311. return procCreateSymbolicLinkW.Find()
  1312. }
  1313. // Readlink returns the destination of the named symbolic link.
  1314. func Readlink(path string, buf []byte) (n int, err error) {
  1315. fd, err := CreateFile(StringToUTF16Ptr(path), GENERIC_READ, 0, nil, OPEN_EXISTING,
  1316. FILE_FLAG_OPEN_REPARSE_POINT|FILE_FLAG_BACKUP_SEMANTICS, 0)
  1317. if err != nil {
  1318. return -1, err
  1319. }
  1320. defer CloseHandle(fd)
  1321. rdbbuf := make([]byte, MAXIMUM_REPARSE_DATA_BUFFER_SIZE)
  1322. var bytesReturned uint32
  1323. err = DeviceIoControl(fd, FSCTL_GET_REPARSE_POINT, nil, 0, &rdbbuf[0], uint32(len(rdbbuf)), &bytesReturned, nil)
  1324. if err != nil {
  1325. return -1, err
  1326. }
  1327. rdb := (*reparseDataBuffer)(unsafe.Pointer(&rdbbuf[0]))
  1328. var s string
  1329. switch rdb.ReparseTag {
  1330. case IO_REPARSE_TAG_SYMLINK:
  1331. data := (*symbolicLinkReparseBuffer)(unsafe.Pointer(&rdb.reparseBuffer))
  1332. p := (*[0xffff]uint16)(unsafe.Pointer(&data.PathBuffer[0]))
  1333. s = UTF16ToString(p[data.PrintNameOffset/2 : (data.PrintNameLength-data.PrintNameOffset)/2])
  1334. case IO_REPARSE_TAG_MOUNT_POINT:
  1335. data := (*mountPointReparseBuffer)(unsafe.Pointer(&rdb.reparseBuffer))
  1336. p := (*[0xffff]uint16)(unsafe.Pointer(&data.PathBuffer[0]))
  1337. s = UTF16ToString(p[data.PrintNameOffset/2 : (data.PrintNameLength-data.PrintNameOffset)/2])
  1338. default:
  1339. // the path is not a symlink or junction but another type of reparse
  1340. // point
  1341. return -1, syscall.ENOENT
  1342. }
  1343. n = copy(buf, []byte(s))
  1344. return n, nil
  1345. }
  1346. // GUIDFromString parses a string in the form of
  1347. // "{XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}" into a GUID.
  1348. func GUIDFromString(str string) (GUID, error) {
  1349. guid := GUID{}
  1350. str16, err := syscall.UTF16PtrFromString(str)
  1351. if err != nil {
  1352. return guid, err
  1353. }
  1354. err = clsidFromString(str16, &guid)
  1355. if err != nil {
  1356. return guid, err
  1357. }
  1358. return guid, nil
  1359. }
  1360. // GenerateGUID creates a new random GUID.
  1361. func GenerateGUID() (GUID, error) {
  1362. guid := GUID{}
  1363. err := coCreateGuid(&guid)
  1364. if err != nil {
  1365. return guid, err
  1366. }
  1367. return guid, nil
  1368. }
  1369. // String returns the canonical string form of the GUID,
  1370. // in the form of "{XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}".
  1371. func (guid GUID) String() string {
  1372. var str [100]uint16
  1373. chars := stringFromGUID2(&guid, &str[0], int32(len(str)))
  1374. if chars <= 1 {
  1375. return ""
  1376. }
  1377. return string(utf16.Decode(str[:chars-1]))
  1378. }
  1379. // KnownFolderPath returns a well-known folder path for the current user, specified by one of
  1380. // the FOLDERID_ constants, and chosen and optionally created based on a KF_ flag.
  1381. func KnownFolderPath(folderID *KNOWNFOLDERID, flags uint32) (string, error) {
  1382. return Token(0).KnownFolderPath(folderID, flags)
  1383. }
  1384. // KnownFolderPath returns a well-known folder path for the user token, specified by one of
  1385. // the FOLDERID_ constants, and chosen and optionally created based on a KF_ flag.
  1386. func (t Token) KnownFolderPath(folderID *KNOWNFOLDERID, flags uint32) (string, error) {
  1387. var p *uint16
  1388. err := shGetKnownFolderPath(folderID, flags, t, &p)
  1389. if err != nil {
  1390. return "", err
  1391. }
  1392. defer CoTaskMemFree(unsafe.Pointer(p))
  1393. return UTF16PtrToString(p), nil
  1394. }
  1395. // RtlGetVersion returns the version of the underlying operating system, ignoring
  1396. // manifest semantics but is affected by the application compatibility layer.
  1397. func RtlGetVersion() *OsVersionInfoEx {
  1398. info := &OsVersionInfoEx{}
  1399. info.osVersionInfoSize = uint32(unsafe.Sizeof(*info))
  1400. // According to documentation, this function always succeeds.
  1401. // The function doesn't even check the validity of the
  1402. // osVersionInfoSize member. Disassembling ntdll.dll indicates
  1403. // that the documentation is indeed correct about that.
  1404. _ = rtlGetVersion(info)
  1405. return info
  1406. }
  1407. // RtlGetNtVersionNumbers returns the version of the underlying operating system,
  1408. // ignoring manifest semantics and the application compatibility layer.
  1409. func RtlGetNtVersionNumbers() (majorVersion, minorVersion, buildNumber uint32) {
  1410. rtlGetNtVersionNumbers(&majorVersion, &minorVersion, &buildNumber)
  1411. buildNumber &= 0xffff
  1412. return
  1413. }
  1414. // GetProcessPreferredUILanguages retrieves the process preferred UI languages.
  1415. func GetProcessPreferredUILanguages(flags uint32) ([]string, error) {
  1416. return getUILanguages(flags, getProcessPreferredUILanguages)
  1417. }
  1418. // GetThreadPreferredUILanguages retrieves the thread preferred UI languages for the current thread.
  1419. func GetThreadPreferredUILanguages(flags uint32) ([]string, error) {
  1420. return getUILanguages(flags, getThreadPreferredUILanguages)
  1421. }
  1422. // GetUserPreferredUILanguages retrieves information about the user preferred UI languages.
  1423. func GetUserPreferredUILanguages(flags uint32) ([]string, error) {
  1424. return getUILanguages(flags, getUserPreferredUILanguages)
  1425. }
  1426. // GetSystemPreferredUILanguages retrieves the system preferred UI languages.
  1427. func GetSystemPreferredUILanguages(flags uint32) ([]string, error) {
  1428. return getUILanguages(flags, getSystemPreferredUILanguages)
  1429. }
  1430. func getUILanguages(flags uint32, f func(flags uint32, numLanguages *uint32, buf *uint16, bufSize *uint32) error) ([]string, error) {
  1431. size := uint32(128)
  1432. for {
  1433. var numLanguages uint32
  1434. buf := make([]uint16, size)
  1435. err := f(flags, &numLanguages, &buf[0], &size)
  1436. if err == ERROR_INSUFFICIENT_BUFFER {
  1437. continue
  1438. }
  1439. if err != nil {
  1440. return nil, err
  1441. }
  1442. buf = buf[:size]
  1443. if numLanguages == 0 || len(buf) == 0 { // GetProcessPreferredUILanguages may return numLanguages==0 with "\0\0"
  1444. return []string{}, nil
  1445. }
  1446. if buf[len(buf)-1] == 0 {
  1447. buf = buf[:len(buf)-1] // remove terminating null
  1448. }
  1449. languages := make([]string, 0, numLanguages)
  1450. from := 0
  1451. for i, c := range buf {
  1452. if c == 0 {
  1453. languages = append(languages, string(utf16.Decode(buf[from:i])))
  1454. from = i + 1
  1455. }
  1456. }
  1457. return languages, nil
  1458. }
  1459. }
  1460. func SetConsoleCursorPosition(console Handle, position Coord) error {
  1461. return setConsoleCursorPosition(console, *((*uint32)(unsafe.Pointer(&position))))
  1462. }
  1463. func GetStartupInfo(startupInfo *StartupInfo) error {
  1464. getStartupInfo(startupInfo)
  1465. return nil
  1466. }
  1467. func (s NTStatus) Errno() syscall.Errno {
  1468. return rtlNtStatusToDosErrorNoTeb(s)
  1469. }
  1470. func langID(pri, sub uint16) uint32 { return uint32(sub)<<10 | uint32(pri) }
  1471. func (s NTStatus) Error() string {
  1472. b := make([]uint16, 300)
  1473. n, err := FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM|FORMAT_MESSAGE_FROM_HMODULE|FORMAT_MESSAGE_ARGUMENT_ARRAY, modntdll.Handle(), uint32(s), langID(LANG_ENGLISH, SUBLANG_ENGLISH_US), b, nil)
  1474. if err != nil {
  1475. return fmt.Sprintf("NTSTATUS 0x%08x", uint32(s))
  1476. }
  1477. // trim terminating \r and \n
  1478. for ; n > 0 && (b[n-1] == '\n' || b[n-1] == '\r'); n-- {
  1479. }
  1480. return string(utf16.Decode(b[:n]))
  1481. }
  1482. // NewNTUnicodeString returns a new NTUnicodeString structure for use with native
  1483. // NT APIs that work over the NTUnicodeString type. Note that most Windows APIs
  1484. // do not use NTUnicodeString, and instead UTF16PtrFromString should be used for
  1485. // the more common *uint16 string type.
  1486. func NewNTUnicodeString(s string) (*NTUnicodeString, error) {
  1487. var u NTUnicodeString
  1488. s16, err := UTF16PtrFromString(s)
  1489. if err != nil {
  1490. return nil, err
  1491. }
  1492. RtlInitUnicodeString(&u, s16)
  1493. return &u, nil
  1494. }
  1495. // Slice returns a uint16 slice that aliases the data in the NTUnicodeString.
  1496. func (s *NTUnicodeString) Slice() []uint16 {
  1497. slice := unsafe.Slice(s.Buffer, s.MaximumLength)
  1498. return slice[:s.Length]
  1499. }
  1500. func (s *NTUnicodeString) String() string {
  1501. return UTF16ToString(s.Slice())
  1502. }
  1503. // NewNTString returns a new NTString structure for use with native
  1504. // NT APIs that work over the NTString type. Note that most Windows APIs
  1505. // do not use NTString, and instead UTF16PtrFromString should be used for
  1506. // the more common *uint16 string type.
  1507. func NewNTString(s string) (*NTString, error) {
  1508. var nts NTString
  1509. s8, err := BytePtrFromString(s)
  1510. if err != nil {
  1511. return nil, err
  1512. }
  1513. RtlInitString(&nts, s8)
  1514. return &nts, nil
  1515. }
  1516. // Slice returns a byte slice that aliases the data in the NTString.
  1517. func (s *NTString) Slice() []byte {
  1518. slice := unsafe.Slice(s.Buffer, s.MaximumLength)
  1519. return slice[:s.Length]
  1520. }
  1521. func (s *NTString) String() string {
  1522. return ByteSliceToString(s.Slice())
  1523. }
  1524. // FindResource resolves a resource of the given name and resource type.
  1525. func FindResource(module Handle, name, resType ResourceIDOrString) (Handle, error) {
  1526. var namePtr, resTypePtr uintptr
  1527. var name16, resType16 *uint16
  1528. var err error
  1529. resolvePtr := func(i interface{}, keep **uint16) (uintptr, error) {
  1530. switch v := i.(type) {
  1531. case string:
  1532. *keep, err = UTF16PtrFromString(v)
  1533. if err != nil {
  1534. return 0, err
  1535. }
  1536. return uintptr(unsafe.Pointer(*keep)), nil
  1537. case ResourceID:
  1538. return uintptr(v), nil
  1539. }
  1540. return 0, errorspkg.New("parameter must be a ResourceID or a string")
  1541. }
  1542. namePtr, err = resolvePtr(name, &name16)
  1543. if err != nil {
  1544. return 0, err
  1545. }
  1546. resTypePtr, err = resolvePtr(resType, &resType16)
  1547. if err != nil {
  1548. return 0, err
  1549. }
  1550. resInfo, err := findResource(module, namePtr, resTypePtr)
  1551. runtime.KeepAlive(name16)
  1552. runtime.KeepAlive(resType16)
  1553. return resInfo, err
  1554. }
  1555. func LoadResourceData(module, resInfo Handle) (data []byte, err error) {
  1556. size, err := SizeofResource(module, resInfo)
  1557. if err != nil {
  1558. return
  1559. }
  1560. resData, err := LoadResource(module, resInfo)
  1561. if err != nil {
  1562. return
  1563. }
  1564. ptr, err := LockResource(resData)
  1565. if err != nil {
  1566. return
  1567. }
  1568. data = unsafe.Slice((*byte)(unsafe.Pointer(ptr)), size)
  1569. return
  1570. }
  1571. // PSAPI_WORKING_SET_EX_BLOCK contains extended working set information for a page.
  1572. type PSAPI_WORKING_SET_EX_BLOCK uint64
  1573. // Valid returns the validity of this page.
  1574. // If this bit is 1, the subsequent members are valid; otherwise they should be ignored.
  1575. func (b PSAPI_WORKING_SET_EX_BLOCK) Valid() bool {
  1576. return (b & 1) == 1
  1577. }
  1578. // ShareCount is the number of processes that share this page. The maximum value of this member is 7.
  1579. func (b PSAPI_WORKING_SET_EX_BLOCK) ShareCount() uint64 {
  1580. return b.intField(1, 3)
  1581. }
  1582. // Win32Protection is the memory protection attributes of the page. For a list of values, see
  1583. // https://docs.microsoft.com/en-us/windows/win32/memory/memory-protection-constants
  1584. func (b PSAPI_WORKING_SET_EX_BLOCK) Win32Protection() uint64 {
  1585. return b.intField(4, 11)
  1586. }
  1587. // Shared returns the shared status of this page.
  1588. // If this bit is 1, the page can be shared.
  1589. func (b PSAPI_WORKING_SET_EX_BLOCK) Shared() bool {
  1590. return (b & (1 << 15)) == 1
  1591. }
  1592. // Node is the NUMA node. The maximum value of this member is 63.
  1593. func (b PSAPI_WORKING_SET_EX_BLOCK) Node() uint64 {
  1594. return b.intField(16, 6)
  1595. }
  1596. // Locked returns the locked status of this page.
  1597. // If this bit is 1, the virtual page is locked in physical memory.
  1598. func (b PSAPI_WORKING_SET_EX_BLOCK) Locked() bool {
  1599. return (b & (1 << 22)) == 1
  1600. }
  1601. // LargePage returns the large page status of this page.
  1602. // If this bit is 1, the page is a large page.
  1603. func (b PSAPI_WORKING_SET_EX_BLOCK) LargePage() bool {
  1604. return (b & (1 << 23)) == 1
  1605. }
  1606. // Bad returns the bad status of this page.
  1607. // If this bit is 1, the page is has been reported as bad.
  1608. func (b PSAPI_WORKING_SET_EX_BLOCK) Bad() bool {
  1609. return (b & (1 << 31)) == 1
  1610. }
  1611. // intField extracts an integer field in the PSAPI_WORKING_SET_EX_BLOCK union.
  1612. func (b PSAPI_WORKING_SET_EX_BLOCK) intField(start, length int) uint64 {
  1613. var mask PSAPI_WORKING_SET_EX_BLOCK
  1614. for pos := start; pos < start+length; pos++ {
  1615. mask |= (1 << pos)
  1616. }
  1617. masked := b & mask
  1618. return uint64(masked >> start)
  1619. }
  1620. // PSAPI_WORKING_SET_EX_INFORMATION contains extended working set information for a process.
  1621. type PSAPI_WORKING_SET_EX_INFORMATION struct {
  1622. // The virtual address.
  1623. VirtualAddress Pointer
  1624. // A PSAPI_WORKING_SET_EX_BLOCK union that indicates the attributes of the page at VirtualAddress.
  1625. VirtualAttributes PSAPI_WORKING_SET_EX_BLOCK
  1626. }
  1627. // CreatePseudoConsole creates a windows pseudo console.
  1628. func CreatePseudoConsole(size Coord, in Handle, out Handle, flags uint32, pconsole *Handle) error {
  1629. // We need this wrapper to manually cast Coord to uint32. The autogenerated wrappers only
  1630. // accept arguments that can be casted to uintptr, and Coord can't.
  1631. return createPseudoConsole(*((*uint32)(unsafe.Pointer(&size))), in, out, flags, pconsole)
  1632. }
  1633. // ResizePseudoConsole resizes the internal buffers of the pseudo console to the width and height specified in `size`.
  1634. func ResizePseudoConsole(pconsole Handle, size Coord) error {
  1635. // We need this wrapper to manually cast Coord to uint32. The autogenerated wrappers only
  1636. // accept arguments that can be casted to uintptr, and Coord can't.
  1637. return resizePseudoConsole(pconsole, *((*uint32)(unsafe.Pointer(&size))))
  1638. }