syscall_windows.go 54 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372
  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. "sync"
  9. "syscall"
  10. "time"
  11. "unicode/utf16"
  12. "unsafe"
  13. )
  14. type Handle uintptr
  15. const (
  16. InvalidHandle = ^Handle(0)
  17. // Flags for DefineDosDevice.
  18. DDD_EXACT_MATCH_ON_REMOVE = 0x00000004
  19. DDD_NO_BROADCAST_SYSTEM = 0x00000008
  20. DDD_RAW_TARGET_PATH = 0x00000001
  21. DDD_REMOVE_DEFINITION = 0x00000002
  22. // Return values for GetDriveType.
  23. DRIVE_UNKNOWN = 0
  24. DRIVE_NO_ROOT_DIR = 1
  25. DRIVE_REMOVABLE = 2
  26. DRIVE_FIXED = 3
  27. DRIVE_REMOTE = 4
  28. DRIVE_CDROM = 5
  29. DRIVE_RAMDISK = 6
  30. // File system flags from GetVolumeInformation and GetVolumeInformationByHandle.
  31. FILE_CASE_SENSITIVE_SEARCH = 0x00000001
  32. FILE_CASE_PRESERVED_NAMES = 0x00000002
  33. FILE_FILE_COMPRESSION = 0x00000010
  34. FILE_DAX_VOLUME = 0x20000000
  35. FILE_NAMED_STREAMS = 0x00040000
  36. FILE_PERSISTENT_ACLS = 0x00000008
  37. FILE_READ_ONLY_VOLUME = 0x00080000
  38. FILE_SEQUENTIAL_WRITE_ONCE = 0x00100000
  39. FILE_SUPPORTS_ENCRYPTION = 0x00020000
  40. FILE_SUPPORTS_EXTENDED_ATTRIBUTES = 0x00800000
  41. FILE_SUPPORTS_HARD_LINKS = 0x00400000
  42. FILE_SUPPORTS_OBJECT_IDS = 0x00010000
  43. FILE_SUPPORTS_OPEN_BY_FILE_ID = 0x01000000
  44. FILE_SUPPORTS_REPARSE_POINTS = 0x00000080
  45. FILE_SUPPORTS_SPARSE_FILES = 0x00000040
  46. FILE_SUPPORTS_TRANSACTIONS = 0x00200000
  47. FILE_SUPPORTS_USN_JOURNAL = 0x02000000
  48. FILE_UNICODE_ON_DISK = 0x00000004
  49. FILE_VOLUME_IS_COMPRESSED = 0x00008000
  50. FILE_VOLUME_QUOTAS = 0x00000020
  51. // Flags for LockFileEx.
  52. LOCKFILE_FAIL_IMMEDIATELY = 0x00000001
  53. LOCKFILE_EXCLUSIVE_LOCK = 0x00000002
  54. // Return values of SleepEx and other APC functions
  55. STATUS_USER_APC = 0x000000C0
  56. WAIT_IO_COMPLETION = STATUS_USER_APC
  57. )
  58. // StringToUTF16 is deprecated. Use UTF16FromString instead.
  59. // If s contains a NUL byte this function panics instead of
  60. // returning an error.
  61. func StringToUTF16(s string) []uint16 {
  62. a, err := UTF16FromString(s)
  63. if err != nil {
  64. panic("windows: string with NUL passed to StringToUTF16")
  65. }
  66. return a
  67. }
  68. // UTF16FromString returns the UTF-16 encoding of the UTF-8 string
  69. // s, with a terminating NUL added. If s contains a NUL byte at any
  70. // location, it returns (nil, syscall.EINVAL).
  71. func UTF16FromString(s string) ([]uint16, error) {
  72. for i := 0; i < len(s); i++ {
  73. if s[i] == 0 {
  74. return nil, syscall.EINVAL
  75. }
  76. }
  77. return utf16.Encode([]rune(s + "\x00")), nil
  78. }
  79. // UTF16ToString returns the UTF-8 encoding of the UTF-16 sequence s,
  80. // with a terminating NUL removed.
  81. func UTF16ToString(s []uint16) string {
  82. for i, v := range s {
  83. if v == 0 {
  84. s = s[0:i]
  85. break
  86. }
  87. }
  88. return string(utf16.Decode(s))
  89. }
  90. // StringToUTF16Ptr is deprecated. Use UTF16PtrFromString instead.
  91. // If s contains a NUL byte this function panics instead of
  92. // returning an error.
  93. func StringToUTF16Ptr(s string) *uint16 { return &StringToUTF16(s)[0] }
  94. // UTF16PtrFromString returns pointer to the UTF-16 encoding of
  95. // the UTF-8 string s, with a terminating NUL added. If s
  96. // contains a NUL byte at any location, it returns (nil, syscall.EINVAL).
  97. func UTF16PtrFromString(s string) (*uint16, error) {
  98. a, err := UTF16FromString(s)
  99. if err != nil {
  100. return nil, err
  101. }
  102. return &a[0], nil
  103. }
  104. func Getpagesize() int { return 4096 }
  105. // NewCallback converts a Go function to a function pointer conforming to the stdcall calling convention.
  106. // This is useful when interoperating with Windows code requiring callbacks.
  107. // The argument is expected to be a function with with one uintptr-sized result. The function must not have arguments with size larger than the size of uintptr.
  108. func NewCallback(fn interface{}) uintptr {
  109. return syscall.NewCallback(fn)
  110. }
  111. // NewCallbackCDecl converts a Go function to a function pointer conforming to the cdecl calling convention.
  112. // This is useful when interoperating with Windows code requiring callbacks.
  113. // The argument is expected to be a function with with one uintptr-sized result. The function must not have arguments with size larger than the size of uintptr.
  114. func NewCallbackCDecl(fn interface{}) uintptr {
  115. return syscall.NewCallbackCDecl(fn)
  116. }
  117. // windows api calls
  118. //sys GetLastError() (lasterr error)
  119. //sys LoadLibrary(libname string) (handle Handle, err error) = LoadLibraryW
  120. //sys LoadLibraryEx(libname string, zero Handle, flags uintptr) (handle Handle, err error) = LoadLibraryExW
  121. //sys FreeLibrary(handle Handle) (err error)
  122. //sys GetProcAddress(module Handle, procname string) (proc uintptr, err error)
  123. //sys GetModuleFileName(module Handle, filename *uint16, size uint32) (n uint32, err error) = kernel32.GetModuleFileNameW
  124. //sys GetModuleHandleEx(flags uint32, moduleName *uint16, module *Handle) (err error) = kernel32.GetModuleHandleExW
  125. //sys GetVersion() (ver uint32, err error)
  126. //sys FormatMessage(flags uint32, msgsrc uintptr, msgid uint32, langid uint32, buf []uint16, args *byte) (n uint32, err error) = FormatMessageW
  127. //sys ExitProcess(exitcode uint32)
  128. //sys IsWow64Process(handle Handle, isWow64 *bool) (err error) = IsWow64Process
  129. //sys CreateFile(name *uint16, access uint32, mode uint32, sa *SecurityAttributes, createmode uint32, attrs uint32, templatefile Handle) (handle Handle, err error) [failretval==InvalidHandle] = CreateFileW
  130. //sys ReadFile(handle Handle, buf []byte, done *uint32, overlapped *Overlapped) (err error)
  131. //sys WriteFile(handle Handle, buf []byte, done *uint32, overlapped *Overlapped) (err error)
  132. //sys GetOverlappedResult(handle Handle, overlapped *Overlapped, done *uint32, wait bool) (err error)
  133. //sys SetFilePointer(handle Handle, lowoffset int32, highoffsetptr *int32, whence uint32) (newlowoffset uint32, err error) [failretval==0xffffffff]
  134. //sys CloseHandle(handle Handle) (err error)
  135. //sys GetStdHandle(stdhandle uint32) (handle Handle, err error) [failretval==InvalidHandle]
  136. //sys SetStdHandle(stdhandle uint32, handle Handle) (err error)
  137. //sys findFirstFile1(name *uint16, data *win32finddata1) (handle Handle, err error) [failretval==InvalidHandle] = FindFirstFileW
  138. //sys findNextFile1(handle Handle, data *win32finddata1) (err error) = FindNextFileW
  139. //sys FindClose(handle Handle) (err error)
  140. //sys GetFileInformationByHandle(handle Handle, data *ByHandleFileInformation) (err error)
  141. //sys GetFileInformationByHandleEx(handle Handle, class uint32, outBuffer *byte, outBufferLen uint32) (err error)
  142. //sys GetCurrentDirectory(buflen uint32, buf *uint16) (n uint32, err error) = GetCurrentDirectoryW
  143. //sys SetCurrentDirectory(path *uint16) (err error) = SetCurrentDirectoryW
  144. //sys CreateDirectory(path *uint16, sa *SecurityAttributes) (err error) = CreateDirectoryW
  145. //sys RemoveDirectory(path *uint16) (err error) = RemoveDirectoryW
  146. //sys DeleteFile(path *uint16) (err error) = DeleteFileW
  147. //sys MoveFile(from *uint16, to *uint16) (err error) = MoveFileW
  148. //sys MoveFileEx(from *uint16, to *uint16, flags uint32) (err error) = MoveFileExW
  149. //sys LockFileEx(file Handle, flags uint32, reserved uint32, bytesLow uint32, bytesHigh uint32, overlapped *Overlapped) (err error)
  150. //sys UnlockFileEx(file Handle, reserved uint32, bytesLow uint32, bytesHigh uint32, overlapped *Overlapped) (err error)
  151. //sys GetComputerName(buf *uint16, n *uint32) (err error) = GetComputerNameW
  152. //sys GetComputerNameEx(nametype uint32, buf *uint16, n *uint32) (err error) = GetComputerNameExW
  153. //sys SetEndOfFile(handle Handle) (err error)
  154. //sys GetSystemTimeAsFileTime(time *Filetime)
  155. //sys GetSystemTimePreciseAsFileTime(time *Filetime)
  156. //sys GetTimeZoneInformation(tzi *Timezoneinformation) (rc uint32, err error) [failretval==0xffffffff]
  157. //sys CreateIoCompletionPort(filehandle Handle, cphandle Handle, key uint32, threadcnt uint32) (handle Handle, err error)
  158. //sys GetQueuedCompletionStatus(cphandle Handle, qty *uint32, key *uint32, overlapped **Overlapped, timeout uint32) (err error)
  159. //sys PostQueuedCompletionStatus(cphandle Handle, qty uint32, key uint32, overlapped *Overlapped) (err error)
  160. //sys CancelIo(s Handle) (err error)
  161. //sys CancelIoEx(s Handle, o *Overlapped) (err error)
  162. //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
  163. //sys OpenProcess(desiredAccess uint32, inheritHandle bool, processId uint32) (handle Handle, err error)
  164. //sys ShellExecute(hwnd Handle, verb *uint16, file *uint16, args *uint16, cwd *uint16, showCmd int32) (err error) = shell32.ShellExecuteW
  165. //sys shGetKnownFolderPath(id *KNOWNFOLDERID, flags uint32, token Token, path **uint16) (ret error) = shell32.SHGetKnownFolderPath
  166. //sys TerminateProcess(handle Handle, exitcode uint32) (err error)
  167. //sys GetExitCodeProcess(handle Handle, exitcode *uint32) (err error)
  168. //sys GetStartupInfo(startupInfo *StartupInfo) (err error) = GetStartupInfoW
  169. //sys GetProcessTimes(handle Handle, creationTime *Filetime, exitTime *Filetime, kernelTime *Filetime, userTime *Filetime) (err error)
  170. //sys DuplicateHandle(hSourceProcessHandle Handle, hSourceHandle Handle, hTargetProcessHandle Handle, lpTargetHandle *Handle, dwDesiredAccess uint32, bInheritHandle bool, dwOptions uint32) (err error)
  171. //sys WaitForSingleObject(handle Handle, waitMilliseconds uint32) (event uint32, err error) [failretval==0xffffffff]
  172. //sys waitForMultipleObjects(count uint32, handles uintptr, waitAll bool, waitMilliseconds uint32) (event uint32, err error) [failretval==0xffffffff] = WaitForMultipleObjects
  173. //sys GetTempPath(buflen uint32, buf *uint16) (n uint32, err error) = GetTempPathW
  174. //sys CreatePipe(readhandle *Handle, writehandle *Handle, sa *SecurityAttributes, size uint32) (err error)
  175. //sys GetFileType(filehandle Handle) (n uint32, err error)
  176. //sys CryptAcquireContext(provhandle *Handle, container *uint16, provider *uint16, provtype uint32, flags uint32) (err error) = advapi32.CryptAcquireContextW
  177. //sys CryptReleaseContext(provhandle Handle, flags uint32) (err error) = advapi32.CryptReleaseContext
  178. //sys CryptGenRandom(provhandle Handle, buflen uint32, buf *byte) (err error) = advapi32.CryptGenRandom
  179. //sys GetEnvironmentStrings() (envs *uint16, err error) [failretval==nil] = kernel32.GetEnvironmentStringsW
  180. //sys FreeEnvironmentStrings(envs *uint16) (err error) = kernel32.FreeEnvironmentStringsW
  181. //sys GetEnvironmentVariable(name *uint16, buffer *uint16, size uint32) (n uint32, err error) = kernel32.GetEnvironmentVariableW
  182. //sys SetEnvironmentVariable(name *uint16, value *uint16) (err error) = kernel32.SetEnvironmentVariableW
  183. //sys CreateEnvironmentBlock(block **uint16, token Token, inheritExisting bool) (err error) = userenv.CreateEnvironmentBlock
  184. //sys DestroyEnvironmentBlock(block *uint16) (err error) = userenv.DestroyEnvironmentBlock
  185. //sys getTickCount64() (ms uint64) = kernel32.GetTickCount64
  186. //sys SetFileTime(handle Handle, ctime *Filetime, atime *Filetime, wtime *Filetime) (err error)
  187. //sys GetFileAttributes(name *uint16) (attrs uint32, err error) [failretval==INVALID_FILE_ATTRIBUTES] = kernel32.GetFileAttributesW
  188. //sys SetFileAttributes(name *uint16, attrs uint32) (err error) = kernel32.SetFileAttributesW
  189. //sys GetFileAttributesEx(name *uint16, level uint32, info *byte) (err error) = kernel32.GetFileAttributesExW
  190. //sys GetCommandLine() (cmd *uint16) = kernel32.GetCommandLineW
  191. //sys CommandLineToArgv(cmd *uint16, argc *int32) (argv *[8192]*[8192]uint16, err error) [failretval==nil] = shell32.CommandLineToArgvW
  192. //sys LocalFree(hmem Handle) (handle Handle, err error) [failretval!=0]
  193. //sys SetHandleInformation(handle Handle, mask uint32, flags uint32) (err error)
  194. //sys FlushFileBuffers(handle Handle) (err error)
  195. //sys GetFullPathName(path *uint16, buflen uint32, buf *uint16, fname **uint16) (n uint32, err error) = kernel32.GetFullPathNameW
  196. //sys GetLongPathName(path *uint16, buf *uint16, buflen uint32) (n uint32, err error) = kernel32.GetLongPathNameW
  197. //sys GetShortPathName(longpath *uint16, shortpath *uint16, buflen uint32) (n uint32, err error) = kernel32.GetShortPathNameW
  198. //sys CreateFileMapping(fhandle Handle, sa *SecurityAttributes, prot uint32, maxSizeHigh uint32, maxSizeLow uint32, name *uint16) (handle Handle, err error) = kernel32.CreateFileMappingW
  199. //sys MapViewOfFile(handle Handle, access uint32, offsetHigh uint32, offsetLow uint32, length uintptr) (addr uintptr, err error)
  200. //sys UnmapViewOfFile(addr uintptr) (err error)
  201. //sys FlushViewOfFile(addr uintptr, length uintptr) (err error)
  202. //sys VirtualLock(addr uintptr, length uintptr) (err error)
  203. //sys VirtualUnlock(addr uintptr, length uintptr) (err error)
  204. //sys VirtualAlloc(address uintptr, size uintptr, alloctype uint32, protect uint32) (value uintptr, err error) = kernel32.VirtualAlloc
  205. //sys VirtualFree(address uintptr, size uintptr, freetype uint32) (err error) = kernel32.VirtualFree
  206. //sys VirtualProtect(address uintptr, size uintptr, newprotect uint32, oldprotect *uint32) (err error) = kernel32.VirtualProtect
  207. //sys TransmitFile(s Handle, handle Handle, bytesToWrite uint32, bytsPerSend uint32, overlapped *Overlapped, transmitFileBuf *TransmitFileBuffers, flags uint32) (err error) = mswsock.TransmitFile
  208. //sys ReadDirectoryChanges(handle Handle, buf *byte, buflen uint32, watchSubTree bool, mask uint32, retlen *uint32, overlapped *Overlapped, completionRoutine uintptr) (err error) = kernel32.ReadDirectoryChangesW
  209. //sys CertOpenSystemStore(hprov Handle, name *uint16) (store Handle, err error) = crypt32.CertOpenSystemStoreW
  210. //sys CertOpenStore(storeProvider uintptr, msgAndCertEncodingType uint32, cryptProv uintptr, flags uint32, para uintptr) (handle Handle, err error) [failretval==InvalidHandle] = crypt32.CertOpenStore
  211. //sys CertEnumCertificatesInStore(store Handle, prevContext *CertContext) (context *CertContext, err error) [failretval==nil] = crypt32.CertEnumCertificatesInStore
  212. //sys CertAddCertificateContextToStore(store Handle, certContext *CertContext, addDisposition uint32, storeContext **CertContext) (err error) = crypt32.CertAddCertificateContextToStore
  213. //sys CertCloseStore(store Handle, flags uint32) (err error) = crypt32.CertCloseStore
  214. //sys CertGetCertificateChain(engine Handle, leaf *CertContext, time *Filetime, additionalStore Handle, para *CertChainPara, flags uint32, reserved uintptr, chainCtx **CertChainContext) (err error) = crypt32.CertGetCertificateChain
  215. //sys CertFreeCertificateChain(ctx *CertChainContext) = crypt32.CertFreeCertificateChain
  216. //sys CertCreateCertificateContext(certEncodingType uint32, certEncoded *byte, encodedLen uint32) (context *CertContext, err error) [failretval==nil] = crypt32.CertCreateCertificateContext
  217. //sys CertFreeCertificateContext(ctx *CertContext) (err error) = crypt32.CertFreeCertificateContext
  218. //sys CertVerifyCertificateChainPolicy(policyOID uintptr, chain *CertChainContext, para *CertChainPolicyPara, status *CertChainPolicyStatus) (err error) = crypt32.CertVerifyCertificateChainPolicy
  219. //sys RegOpenKeyEx(key Handle, subkey *uint16, options uint32, desiredAccess uint32, result *Handle) (regerrno error) = advapi32.RegOpenKeyExW
  220. //sys RegCloseKey(key Handle) (regerrno error) = advapi32.RegCloseKey
  221. //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
  222. //sys RegEnumKeyEx(key Handle, index uint32, name *uint16, nameLen *uint32, reserved *uint32, class *uint16, classLen *uint32, lastWriteTime *Filetime) (regerrno error) = advapi32.RegEnumKeyExW
  223. //sys RegQueryValueEx(key Handle, name *uint16, reserved *uint32, valtype *uint32, buf *byte, buflen *uint32) (regerrno error) = advapi32.RegQueryValueExW
  224. //sys GetCurrentProcessId() (pid uint32) = kernel32.GetCurrentProcessId
  225. //sys GetConsoleMode(console Handle, mode *uint32) (err error) = kernel32.GetConsoleMode
  226. //sys SetConsoleMode(console Handle, mode uint32) (err error) = kernel32.SetConsoleMode
  227. //sys GetConsoleScreenBufferInfo(console Handle, info *ConsoleScreenBufferInfo) (err error) = kernel32.GetConsoleScreenBufferInfo
  228. //sys WriteConsole(console Handle, buf *uint16, towrite uint32, written *uint32, reserved *byte) (err error) = kernel32.WriteConsoleW
  229. //sys ReadConsole(console Handle, buf *uint16, toread uint32, read *uint32, inputControl *byte) (err error) = kernel32.ReadConsoleW
  230. //sys CreateToolhelp32Snapshot(flags uint32, processId uint32) (handle Handle, err error) [failretval==InvalidHandle] = kernel32.CreateToolhelp32Snapshot
  231. //sys Process32First(snapshot Handle, procEntry *ProcessEntry32) (err error) = kernel32.Process32FirstW
  232. //sys Process32Next(snapshot Handle, procEntry *ProcessEntry32) (err error) = kernel32.Process32NextW
  233. //sys Thread32First(snapshot Handle, threadEntry *ThreadEntry32) (err error)
  234. //sys Thread32Next(snapshot Handle, threadEntry *ThreadEntry32) (err error)
  235. //sys DeviceIoControl(handle Handle, ioControlCode uint32, inBuffer *byte, inBufferSize uint32, outBuffer *byte, outBufferSize uint32, bytesReturned *uint32, overlapped *Overlapped) (err error)
  236. // This function returns 1 byte BOOLEAN rather than the 4 byte BOOL.
  237. //sys CreateSymbolicLink(symlinkfilename *uint16, targetfilename *uint16, flags uint32) (err error) [failretval&0xff==0] = CreateSymbolicLinkW
  238. //sys CreateHardLink(filename *uint16, existingfilename *uint16, reserved uintptr) (err error) [failretval&0xff==0] = CreateHardLinkW
  239. //sys GetCurrentThreadId() (id uint32)
  240. //sys CreateEvent(eventAttrs *SecurityAttributes, manualReset uint32, initialState uint32, name *uint16) (handle Handle, err error) = kernel32.CreateEventW
  241. //sys CreateEventEx(eventAttrs *SecurityAttributes, name *uint16, flags uint32, desiredAccess uint32) (handle Handle, err error) = kernel32.CreateEventExW
  242. //sys OpenEvent(desiredAccess uint32, inheritHandle bool, name *uint16) (handle Handle, err error) = kernel32.OpenEventW
  243. //sys SetEvent(event Handle) (err error) = kernel32.SetEvent
  244. //sys ResetEvent(event Handle) (err error) = kernel32.ResetEvent
  245. //sys PulseEvent(event Handle) (err error) = kernel32.PulseEvent
  246. //sys CreateMutex(mutexAttrs *SecurityAttributes, initialOwner bool, name *uint16) (handle Handle, err error) = kernel32.CreateMutexW
  247. //sys CreateMutexEx(mutexAttrs *SecurityAttributes, name *uint16, flags uint32, desiredAccess uint32) (handle Handle, err error) = kernel32.CreateMutexExW
  248. //sys OpenMutex(desiredAccess uint32, inheritHandle bool, name *uint16) (handle Handle, err error) = kernel32.OpenMutexW
  249. //sys ReleaseMutex(mutex Handle) (err error) = kernel32.ReleaseMutex
  250. //sys SleepEx(milliseconds uint32, alertable bool) (ret uint32) = kernel32.SleepEx
  251. //sys CreateJobObject(jobAttr *SecurityAttributes, name *uint16) (handle Handle, err error) = kernel32.CreateJobObjectW
  252. //sys AssignProcessToJobObject(job Handle, process Handle) (err error) = kernel32.AssignProcessToJobObject
  253. //sys TerminateJobObject(job Handle, exitCode uint32) (err error) = kernel32.TerminateJobObject
  254. //sys SetErrorMode(mode uint32) (ret uint32) = kernel32.SetErrorMode
  255. //sys ResumeThread(thread Handle) (ret uint32, err error) [failretval==0xffffffff] = kernel32.ResumeThread
  256. //sys SetPriorityClass(process Handle, priorityClass uint32) (err error) = kernel32.SetPriorityClass
  257. //sys GetPriorityClass(process Handle) (ret uint32, err error) = kernel32.GetPriorityClass
  258. //sys SetInformationJobObject(job Handle, JobObjectInformationClass uint32, JobObjectInformation uintptr, JobObjectInformationLength uint32) (ret int, err error)
  259. //sys GenerateConsoleCtrlEvent(ctrlEvent uint32, processGroupID uint32) (err error)
  260. //sys GetProcessId(process Handle) (id uint32, err error)
  261. //sys OpenThread(desiredAccess uint32, inheritHandle bool, threadId uint32) (handle Handle, err error)
  262. //sys SetProcessPriorityBoost(process Handle, disable bool) (err error) = kernel32.SetProcessPriorityBoost
  263. // Volume Management Functions
  264. //sys DefineDosDevice(flags uint32, deviceName *uint16, targetPath *uint16) (err error) = DefineDosDeviceW
  265. //sys DeleteVolumeMountPoint(volumeMountPoint *uint16) (err error) = DeleteVolumeMountPointW
  266. //sys FindFirstVolume(volumeName *uint16, bufferLength uint32) (handle Handle, err error) [failretval==InvalidHandle] = FindFirstVolumeW
  267. //sys FindFirstVolumeMountPoint(rootPathName *uint16, volumeMountPoint *uint16, bufferLength uint32) (handle Handle, err error) [failretval==InvalidHandle] = FindFirstVolumeMountPointW
  268. //sys FindNextVolume(findVolume Handle, volumeName *uint16, bufferLength uint32) (err error) = FindNextVolumeW
  269. //sys FindNextVolumeMountPoint(findVolumeMountPoint Handle, volumeMountPoint *uint16, bufferLength uint32) (err error) = FindNextVolumeMountPointW
  270. //sys FindVolumeClose(findVolume Handle) (err error)
  271. //sys FindVolumeMountPointClose(findVolumeMountPoint Handle) (err error)
  272. //sys GetDriveType(rootPathName *uint16) (driveType uint32) = GetDriveTypeW
  273. //sys GetLogicalDrives() (drivesBitMask uint32, err error) [failretval==0]
  274. //sys GetLogicalDriveStrings(bufferLength uint32, buffer *uint16) (n uint32, err error) [failretval==0] = GetLogicalDriveStringsW
  275. //sys GetVolumeInformation(rootPathName *uint16, volumeNameBuffer *uint16, volumeNameSize uint32, volumeNameSerialNumber *uint32, maximumComponentLength *uint32, fileSystemFlags *uint32, fileSystemNameBuffer *uint16, fileSystemNameSize uint32) (err error) = GetVolumeInformationW
  276. //sys GetVolumeInformationByHandle(file Handle, volumeNameBuffer *uint16, volumeNameSize uint32, volumeNameSerialNumber *uint32, maximumComponentLength *uint32, fileSystemFlags *uint32, fileSystemNameBuffer *uint16, fileSystemNameSize uint32) (err error) = GetVolumeInformationByHandleW
  277. //sys GetVolumeNameForVolumeMountPoint(volumeMountPoint *uint16, volumeName *uint16, bufferlength uint32) (err error) = GetVolumeNameForVolumeMountPointW
  278. //sys GetVolumePathName(fileName *uint16, volumePathName *uint16, bufferLength uint32) (err error) = GetVolumePathNameW
  279. //sys GetVolumePathNamesForVolumeName(volumeName *uint16, volumePathNames *uint16, bufferLength uint32, returnLength *uint32) (err error) = GetVolumePathNamesForVolumeNameW
  280. //sys QueryDosDevice(deviceName *uint16, targetPath *uint16, max uint32) (n uint32, err error) [failretval==0] = QueryDosDeviceW
  281. //sys SetVolumeLabel(rootPathName *uint16, volumeName *uint16) (err error) = SetVolumeLabelW
  282. //sys SetVolumeMountPoint(volumeMountPoint *uint16, volumeName *uint16) (err error) = SetVolumeMountPointW
  283. //sys MessageBox(hwnd Handle, text *uint16, caption *uint16, boxtype uint32) (ret int32, err error) [failretval==0] = user32.MessageBoxW
  284. //sys ExitWindowsEx(flags uint32, reason uint32) (err error) = user32.ExitWindowsEx
  285. //sys InitiateSystemShutdownEx(machineName *uint16, message *uint16, timeout uint32, forceAppsClosed bool, rebootAfterShutdown bool, reason uint32) (err error) = advapi32.InitiateSystemShutdownExW
  286. //sys SetProcessShutdownParameters(level uint32, flags uint32) (err error) = kernel32.SetProcessShutdownParameters
  287. //sys GetProcessShutdownParameters(level *uint32, flags *uint32) (err error) = kernel32.GetProcessShutdownParameters
  288. //sys clsidFromString(lpsz *uint16, pclsid *GUID) (ret error) = ole32.CLSIDFromString
  289. //sys stringFromGUID2(rguid *GUID, lpsz *uint16, cchMax int32) (chars int32) = ole32.StringFromGUID2
  290. //sys coCreateGuid(pguid *GUID) (ret error) = ole32.CoCreateGuid
  291. //sys CoTaskMemFree(address unsafe.Pointer) = ole32.CoTaskMemFree
  292. //sys rtlGetVersion(info *OsVersionInfoEx) (ret error) = ntdll.RtlGetVersion
  293. //sys rtlGetNtVersionNumbers(majorVersion *uint32, minorVersion *uint32, buildNumber *uint32) = ntdll.RtlGetNtVersionNumbers
  294. // syscall interface implementation for other packages
  295. // GetCurrentProcess returns the handle for the current process.
  296. // It is a pseudo handle that does not need to be closed.
  297. // The returned error is always nil.
  298. //
  299. // Deprecated: use CurrentProcess for the same Handle without the nil
  300. // error.
  301. func GetCurrentProcess() (Handle, error) {
  302. return CurrentProcess(), nil
  303. }
  304. // CurrentProcess returns the handle for the current process.
  305. // It is a pseudo handle that does not need to be closed.
  306. func CurrentProcess() Handle { return Handle(^uintptr(1 - 1)) }
  307. // GetCurrentThread returns the handle for the current thread.
  308. // It is a pseudo handle that does not need to be closed.
  309. // The returned error is always nil.
  310. //
  311. // Deprecated: use CurrentThread for the same Handle without the nil
  312. // error.
  313. func GetCurrentThread() (Handle, error) {
  314. return CurrentThread(), nil
  315. }
  316. // CurrentThread returns the handle for the current thread.
  317. // It is a pseudo handle that does not need to be closed.
  318. func CurrentThread() Handle { return Handle(^uintptr(2 - 1)) }
  319. // GetProcAddressByOrdinal retrieves the address of the exported
  320. // function from module by ordinal.
  321. func GetProcAddressByOrdinal(module Handle, ordinal uintptr) (proc uintptr, err error) {
  322. r0, _, e1 := syscall.Syscall(procGetProcAddress.Addr(), 2, uintptr(module), ordinal, 0)
  323. proc = uintptr(r0)
  324. if proc == 0 {
  325. if e1 != 0 {
  326. err = errnoErr(e1)
  327. } else {
  328. err = syscall.EINVAL
  329. }
  330. }
  331. return
  332. }
  333. func Exit(code int) { ExitProcess(uint32(code)) }
  334. func makeInheritSa() *SecurityAttributes {
  335. var sa SecurityAttributes
  336. sa.Length = uint32(unsafe.Sizeof(sa))
  337. sa.InheritHandle = 1
  338. return &sa
  339. }
  340. func Open(path string, mode int, perm uint32) (fd Handle, err error) {
  341. if len(path) == 0 {
  342. return InvalidHandle, ERROR_FILE_NOT_FOUND
  343. }
  344. pathp, err := UTF16PtrFromString(path)
  345. if err != nil {
  346. return InvalidHandle, err
  347. }
  348. var access uint32
  349. switch mode & (O_RDONLY | O_WRONLY | O_RDWR) {
  350. case O_RDONLY:
  351. access = GENERIC_READ
  352. case O_WRONLY:
  353. access = GENERIC_WRITE
  354. case O_RDWR:
  355. access = GENERIC_READ | GENERIC_WRITE
  356. }
  357. if mode&O_CREAT != 0 {
  358. access |= GENERIC_WRITE
  359. }
  360. if mode&O_APPEND != 0 {
  361. access &^= GENERIC_WRITE
  362. access |= FILE_APPEND_DATA
  363. }
  364. sharemode := uint32(FILE_SHARE_READ | FILE_SHARE_WRITE)
  365. var sa *SecurityAttributes
  366. if mode&O_CLOEXEC == 0 {
  367. sa = makeInheritSa()
  368. }
  369. var createmode uint32
  370. switch {
  371. case mode&(O_CREAT|O_EXCL) == (O_CREAT | O_EXCL):
  372. createmode = CREATE_NEW
  373. case mode&(O_CREAT|O_TRUNC) == (O_CREAT | O_TRUNC):
  374. createmode = CREATE_ALWAYS
  375. case mode&O_CREAT == O_CREAT:
  376. createmode = OPEN_ALWAYS
  377. case mode&O_TRUNC == O_TRUNC:
  378. createmode = TRUNCATE_EXISTING
  379. default:
  380. createmode = OPEN_EXISTING
  381. }
  382. h, e := CreateFile(pathp, access, sharemode, sa, createmode, FILE_ATTRIBUTE_NORMAL, 0)
  383. return h, e
  384. }
  385. func Read(fd Handle, p []byte) (n int, err error) {
  386. var done uint32
  387. e := ReadFile(fd, p, &done, nil)
  388. if e != nil {
  389. if e == ERROR_BROKEN_PIPE {
  390. // NOTE(brainman): work around ERROR_BROKEN_PIPE is returned on reading EOF from stdin
  391. return 0, nil
  392. }
  393. return 0, e
  394. }
  395. if raceenabled {
  396. if done > 0 {
  397. raceWriteRange(unsafe.Pointer(&p[0]), int(done))
  398. }
  399. raceAcquire(unsafe.Pointer(&ioSync))
  400. }
  401. return int(done), nil
  402. }
  403. func Write(fd Handle, p []byte) (n int, err error) {
  404. if raceenabled {
  405. raceReleaseMerge(unsafe.Pointer(&ioSync))
  406. }
  407. var done uint32
  408. e := WriteFile(fd, p, &done, nil)
  409. if e != nil {
  410. return 0, e
  411. }
  412. if raceenabled && done > 0 {
  413. raceReadRange(unsafe.Pointer(&p[0]), int(done))
  414. }
  415. return int(done), nil
  416. }
  417. var ioSync int64
  418. func Seek(fd Handle, offset int64, whence int) (newoffset int64, err error) {
  419. var w uint32
  420. switch whence {
  421. case 0:
  422. w = FILE_BEGIN
  423. case 1:
  424. w = FILE_CURRENT
  425. case 2:
  426. w = FILE_END
  427. }
  428. hi := int32(offset >> 32)
  429. lo := int32(offset)
  430. // use GetFileType to check pipe, pipe can't do seek
  431. ft, _ := GetFileType(fd)
  432. if ft == FILE_TYPE_PIPE {
  433. return 0, syscall.EPIPE
  434. }
  435. rlo, e := SetFilePointer(fd, lo, &hi, w)
  436. if e != nil {
  437. return 0, e
  438. }
  439. return int64(hi)<<32 + int64(rlo), nil
  440. }
  441. func Close(fd Handle) (err error) {
  442. return CloseHandle(fd)
  443. }
  444. var (
  445. Stdin = getStdHandle(STD_INPUT_HANDLE)
  446. Stdout = getStdHandle(STD_OUTPUT_HANDLE)
  447. Stderr = getStdHandle(STD_ERROR_HANDLE)
  448. )
  449. func getStdHandle(stdhandle uint32) (fd Handle) {
  450. r, _ := GetStdHandle(stdhandle)
  451. CloseOnExec(r)
  452. return r
  453. }
  454. const ImplementsGetwd = true
  455. func Getwd() (wd string, err error) {
  456. b := make([]uint16, 300)
  457. n, e := GetCurrentDirectory(uint32(len(b)), &b[0])
  458. if e != nil {
  459. return "", e
  460. }
  461. return string(utf16.Decode(b[0:n])), nil
  462. }
  463. func Chdir(path string) (err error) {
  464. pathp, err := UTF16PtrFromString(path)
  465. if err != nil {
  466. return err
  467. }
  468. return SetCurrentDirectory(pathp)
  469. }
  470. func Mkdir(path string, mode uint32) (err error) {
  471. pathp, err := UTF16PtrFromString(path)
  472. if err != nil {
  473. return err
  474. }
  475. return CreateDirectory(pathp, nil)
  476. }
  477. func Rmdir(path string) (err error) {
  478. pathp, err := UTF16PtrFromString(path)
  479. if err != nil {
  480. return err
  481. }
  482. return RemoveDirectory(pathp)
  483. }
  484. func Unlink(path string) (err error) {
  485. pathp, err := UTF16PtrFromString(path)
  486. if err != nil {
  487. return err
  488. }
  489. return DeleteFile(pathp)
  490. }
  491. func Rename(oldpath, newpath string) (err error) {
  492. from, err := UTF16PtrFromString(oldpath)
  493. if err != nil {
  494. return err
  495. }
  496. to, err := UTF16PtrFromString(newpath)
  497. if err != nil {
  498. return err
  499. }
  500. return MoveFileEx(from, to, MOVEFILE_REPLACE_EXISTING)
  501. }
  502. func ComputerName() (name string, err error) {
  503. var n uint32 = MAX_COMPUTERNAME_LENGTH + 1
  504. b := make([]uint16, n)
  505. e := GetComputerName(&b[0], &n)
  506. if e != nil {
  507. return "", e
  508. }
  509. return string(utf16.Decode(b[0:n])), nil
  510. }
  511. func DurationSinceBoot() time.Duration {
  512. return time.Duration(getTickCount64()) * time.Millisecond
  513. }
  514. func Ftruncate(fd Handle, length int64) (err error) {
  515. curoffset, e := Seek(fd, 0, 1)
  516. if e != nil {
  517. return e
  518. }
  519. defer Seek(fd, curoffset, 0)
  520. _, e = Seek(fd, length, 0)
  521. if e != nil {
  522. return e
  523. }
  524. e = SetEndOfFile(fd)
  525. if e != nil {
  526. return e
  527. }
  528. return nil
  529. }
  530. func Gettimeofday(tv *Timeval) (err error) {
  531. var ft Filetime
  532. GetSystemTimeAsFileTime(&ft)
  533. *tv = NsecToTimeval(ft.Nanoseconds())
  534. return nil
  535. }
  536. func Pipe(p []Handle) (err error) {
  537. if len(p) != 2 {
  538. return syscall.EINVAL
  539. }
  540. var r, w Handle
  541. e := CreatePipe(&r, &w, makeInheritSa(), 0)
  542. if e != nil {
  543. return e
  544. }
  545. p[0] = r
  546. p[1] = w
  547. return nil
  548. }
  549. func Utimes(path string, tv []Timeval) (err error) {
  550. if len(tv) != 2 {
  551. return syscall.EINVAL
  552. }
  553. pathp, e := UTF16PtrFromString(path)
  554. if e != nil {
  555. return e
  556. }
  557. h, e := CreateFile(pathp,
  558. FILE_WRITE_ATTRIBUTES, FILE_SHARE_WRITE, nil,
  559. OPEN_EXISTING, FILE_FLAG_BACKUP_SEMANTICS, 0)
  560. if e != nil {
  561. return e
  562. }
  563. defer Close(h)
  564. a := NsecToFiletime(tv[0].Nanoseconds())
  565. w := NsecToFiletime(tv[1].Nanoseconds())
  566. return SetFileTime(h, nil, &a, &w)
  567. }
  568. func UtimesNano(path string, ts []Timespec) (err error) {
  569. if len(ts) != 2 {
  570. return syscall.EINVAL
  571. }
  572. pathp, e := UTF16PtrFromString(path)
  573. if e != nil {
  574. return e
  575. }
  576. h, e := CreateFile(pathp,
  577. FILE_WRITE_ATTRIBUTES, FILE_SHARE_WRITE, nil,
  578. OPEN_EXISTING, FILE_FLAG_BACKUP_SEMANTICS, 0)
  579. if e != nil {
  580. return e
  581. }
  582. defer Close(h)
  583. a := NsecToFiletime(TimespecToNsec(ts[0]))
  584. w := NsecToFiletime(TimespecToNsec(ts[1]))
  585. return SetFileTime(h, nil, &a, &w)
  586. }
  587. func Fsync(fd Handle) (err error) {
  588. return FlushFileBuffers(fd)
  589. }
  590. func Chmod(path string, mode uint32) (err error) {
  591. p, e := UTF16PtrFromString(path)
  592. if e != nil {
  593. return e
  594. }
  595. attrs, e := GetFileAttributes(p)
  596. if e != nil {
  597. return e
  598. }
  599. if mode&S_IWRITE != 0 {
  600. attrs &^= FILE_ATTRIBUTE_READONLY
  601. } else {
  602. attrs |= FILE_ATTRIBUTE_READONLY
  603. }
  604. return SetFileAttributes(p, attrs)
  605. }
  606. func LoadGetSystemTimePreciseAsFileTime() error {
  607. return procGetSystemTimePreciseAsFileTime.Find()
  608. }
  609. func LoadCancelIoEx() error {
  610. return procCancelIoEx.Find()
  611. }
  612. func LoadSetFileCompletionNotificationModes() error {
  613. return procSetFileCompletionNotificationModes.Find()
  614. }
  615. func WaitForMultipleObjects(handles []Handle, waitAll bool, waitMilliseconds uint32) (event uint32, err error) {
  616. // Every other win32 array API takes arguments as "pointer, count", except for this function. So we
  617. // can't declare it as a usual [] type, because mksyscall will use the opposite order. We therefore
  618. // trivially stub this ourselves.
  619. var handlePtr *Handle
  620. if len(handles) > 0 {
  621. handlePtr = &handles[0]
  622. }
  623. return waitForMultipleObjects(uint32(len(handles)), uintptr(unsafe.Pointer(handlePtr)), waitAll, waitMilliseconds)
  624. }
  625. // net api calls
  626. const socket_error = uintptr(^uint32(0))
  627. //sys WSAStartup(verreq uint32, data *WSAData) (sockerr error) = ws2_32.WSAStartup
  628. //sys WSACleanup() (err error) [failretval==socket_error] = ws2_32.WSACleanup
  629. //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
  630. //sys socket(af int32, typ int32, protocol int32) (handle Handle, err error) [failretval==InvalidHandle] = ws2_32.socket
  631. //sys Setsockopt(s Handle, level int32, optname int32, optval *byte, optlen int32) (err error) [failretval==socket_error] = ws2_32.setsockopt
  632. //sys Getsockopt(s Handle, level int32, optname int32, optval *byte, optlen *int32) (err error) [failretval==socket_error] = ws2_32.getsockopt
  633. //sys bind(s Handle, name unsafe.Pointer, namelen int32) (err error) [failretval==socket_error] = ws2_32.bind
  634. //sys connect(s Handle, name unsafe.Pointer, namelen int32) (err error) [failretval==socket_error] = ws2_32.connect
  635. //sys getsockname(s Handle, rsa *RawSockaddrAny, addrlen *int32) (err error) [failretval==socket_error] = ws2_32.getsockname
  636. //sys getpeername(s Handle, rsa *RawSockaddrAny, addrlen *int32) (err error) [failretval==socket_error] = ws2_32.getpeername
  637. //sys listen(s Handle, backlog int32) (err error) [failretval==socket_error] = ws2_32.listen
  638. //sys shutdown(s Handle, how int32) (err error) [failretval==socket_error] = ws2_32.shutdown
  639. //sys Closesocket(s Handle) (err error) [failretval==socket_error] = ws2_32.closesocket
  640. //sys AcceptEx(ls Handle, as Handle, buf *byte, rxdatalen uint32, laddrlen uint32, raddrlen uint32, recvd *uint32, overlapped *Overlapped) (err error) = mswsock.AcceptEx
  641. //sys GetAcceptExSockaddrs(buf *byte, rxdatalen uint32, laddrlen uint32, raddrlen uint32, lrsa **RawSockaddrAny, lrsalen *int32, rrsa **RawSockaddrAny, rrsalen *int32) = mswsock.GetAcceptExSockaddrs
  642. //sys WSARecv(s Handle, bufs *WSABuf, bufcnt uint32, recvd *uint32, flags *uint32, overlapped *Overlapped, croutine *byte) (err error) [failretval==socket_error] = ws2_32.WSARecv
  643. //sys WSASend(s Handle, bufs *WSABuf, bufcnt uint32, sent *uint32, flags uint32, overlapped *Overlapped, croutine *byte) (err error) [failretval==socket_error] = ws2_32.WSASend
  644. //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
  645. //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
  646. //sys GetHostByName(name string) (h *Hostent, err error) [failretval==nil] = ws2_32.gethostbyname
  647. //sys GetServByName(name string, proto string) (s *Servent, err error) [failretval==nil] = ws2_32.getservbyname
  648. //sys Ntohs(netshort uint16) (u uint16) = ws2_32.ntohs
  649. //sys GetProtoByName(name string) (p *Protoent, err error) [failretval==nil] = ws2_32.getprotobyname
  650. //sys DnsQuery(name string, qtype uint16, options uint32, extra *byte, qrs **DNSRecord, pr *byte) (status error) = dnsapi.DnsQuery_W
  651. //sys DnsRecordListFree(rl *DNSRecord, freetype uint32) = dnsapi.DnsRecordListFree
  652. //sys DnsNameCompare(name1 *uint16, name2 *uint16) (same bool) = dnsapi.DnsNameCompare_W
  653. //sys GetAddrInfoW(nodename *uint16, servicename *uint16, hints *AddrinfoW, result **AddrinfoW) (sockerr error) = ws2_32.GetAddrInfoW
  654. //sys FreeAddrInfoW(addrinfo *AddrinfoW) = ws2_32.FreeAddrInfoW
  655. //sys GetIfEntry(pIfRow *MibIfRow) (errcode error) = iphlpapi.GetIfEntry
  656. //sys GetAdaptersInfo(ai *IpAdapterInfo, ol *uint32) (errcode error) = iphlpapi.GetAdaptersInfo
  657. //sys SetFileCompletionNotificationModes(handle Handle, flags uint8) (err error) = kernel32.SetFileCompletionNotificationModes
  658. //sys WSAEnumProtocols(protocols *int32, protocolBuffer *WSAProtocolInfo, bufferLength *uint32) (n int32, err error) [failretval==-1] = ws2_32.WSAEnumProtocolsW
  659. //sys GetAdaptersAddresses(family uint32, flags uint32, reserved uintptr, adapterAddresses *IpAdapterAddresses, sizePointer *uint32) (errcode error) = iphlpapi.GetAdaptersAddresses
  660. //sys GetACP() (acp uint32) = kernel32.GetACP
  661. //sys MultiByteToWideChar(codePage uint32, dwFlags uint32, str *byte, nstr int32, wchar *uint16, nwchar int32) (nwrite int32, err error) = kernel32.MultiByteToWideChar
  662. // For testing: clients can set this flag to force
  663. // creation of IPv6 sockets to return EAFNOSUPPORT.
  664. var SocketDisableIPv6 bool
  665. type RawSockaddrInet4 struct {
  666. Family uint16
  667. Port uint16
  668. Addr [4]byte /* in_addr */
  669. Zero [8]uint8
  670. }
  671. type RawSockaddrInet6 struct {
  672. Family uint16
  673. Port uint16
  674. Flowinfo uint32
  675. Addr [16]byte /* in6_addr */
  676. Scope_id uint32
  677. }
  678. type RawSockaddr struct {
  679. Family uint16
  680. Data [14]int8
  681. }
  682. type RawSockaddrAny struct {
  683. Addr RawSockaddr
  684. Pad [100]int8
  685. }
  686. type Sockaddr interface {
  687. sockaddr() (ptr unsafe.Pointer, len int32, err error) // lowercase; only we can define Sockaddrs
  688. }
  689. type SockaddrInet4 struct {
  690. Port int
  691. Addr [4]byte
  692. raw RawSockaddrInet4
  693. }
  694. func (sa *SockaddrInet4) sockaddr() (unsafe.Pointer, int32, error) {
  695. if sa.Port < 0 || sa.Port > 0xFFFF {
  696. return nil, 0, syscall.EINVAL
  697. }
  698. sa.raw.Family = AF_INET
  699. p := (*[2]byte)(unsafe.Pointer(&sa.raw.Port))
  700. p[0] = byte(sa.Port >> 8)
  701. p[1] = byte(sa.Port)
  702. for i := 0; i < len(sa.Addr); i++ {
  703. sa.raw.Addr[i] = sa.Addr[i]
  704. }
  705. return unsafe.Pointer(&sa.raw), int32(unsafe.Sizeof(sa.raw)), nil
  706. }
  707. type SockaddrInet6 struct {
  708. Port int
  709. ZoneId uint32
  710. Addr [16]byte
  711. raw RawSockaddrInet6
  712. }
  713. func (sa *SockaddrInet6) sockaddr() (unsafe.Pointer, int32, error) {
  714. if sa.Port < 0 || sa.Port > 0xFFFF {
  715. return nil, 0, syscall.EINVAL
  716. }
  717. sa.raw.Family = AF_INET6
  718. p := (*[2]byte)(unsafe.Pointer(&sa.raw.Port))
  719. p[0] = byte(sa.Port >> 8)
  720. p[1] = byte(sa.Port)
  721. sa.raw.Scope_id = sa.ZoneId
  722. for i := 0; i < len(sa.Addr); i++ {
  723. sa.raw.Addr[i] = sa.Addr[i]
  724. }
  725. return unsafe.Pointer(&sa.raw), int32(unsafe.Sizeof(sa.raw)), nil
  726. }
  727. type RawSockaddrUnix struct {
  728. Family uint16
  729. Path [UNIX_PATH_MAX]int8
  730. }
  731. type SockaddrUnix struct {
  732. Name string
  733. raw RawSockaddrUnix
  734. }
  735. func (sa *SockaddrUnix) sockaddr() (unsafe.Pointer, int32, error) {
  736. name := sa.Name
  737. n := len(name)
  738. if n > len(sa.raw.Path) {
  739. return nil, 0, syscall.EINVAL
  740. }
  741. if n == len(sa.raw.Path) && name[0] != '@' {
  742. return nil, 0, syscall.EINVAL
  743. }
  744. sa.raw.Family = AF_UNIX
  745. for i := 0; i < n; i++ {
  746. sa.raw.Path[i] = int8(name[i])
  747. }
  748. // length is family (uint16), name, NUL.
  749. sl := int32(2)
  750. if n > 0 {
  751. sl += int32(n) + 1
  752. }
  753. if sa.raw.Path[0] == '@' {
  754. sa.raw.Path[0] = 0
  755. // Don't count trailing NUL for abstract address.
  756. sl--
  757. }
  758. return unsafe.Pointer(&sa.raw), sl, nil
  759. }
  760. func (rsa *RawSockaddrAny) Sockaddr() (Sockaddr, error) {
  761. switch rsa.Addr.Family {
  762. case AF_UNIX:
  763. pp := (*RawSockaddrUnix)(unsafe.Pointer(rsa))
  764. sa := new(SockaddrUnix)
  765. if pp.Path[0] == 0 {
  766. // "Abstract" Unix domain socket.
  767. // Rewrite leading NUL as @ for textual display.
  768. // (This is the standard convention.)
  769. // Not friendly to overwrite in place,
  770. // but the callers below don't care.
  771. pp.Path[0] = '@'
  772. }
  773. // Assume path ends at NUL.
  774. // This is not technically the Linux semantics for
  775. // abstract Unix domain sockets--they are supposed
  776. // to be uninterpreted fixed-size binary blobs--but
  777. // everyone uses this convention.
  778. n := 0
  779. for n < len(pp.Path) && pp.Path[n] != 0 {
  780. n++
  781. }
  782. bytes := (*[10000]byte)(unsafe.Pointer(&pp.Path[0]))[0:n]
  783. sa.Name = string(bytes)
  784. return sa, nil
  785. case AF_INET:
  786. pp := (*RawSockaddrInet4)(unsafe.Pointer(rsa))
  787. sa := new(SockaddrInet4)
  788. p := (*[2]byte)(unsafe.Pointer(&pp.Port))
  789. sa.Port = int(p[0])<<8 + int(p[1])
  790. for i := 0; i < len(sa.Addr); i++ {
  791. sa.Addr[i] = pp.Addr[i]
  792. }
  793. return sa, nil
  794. case AF_INET6:
  795. pp := (*RawSockaddrInet6)(unsafe.Pointer(rsa))
  796. sa := new(SockaddrInet6)
  797. p := (*[2]byte)(unsafe.Pointer(&pp.Port))
  798. sa.Port = int(p[0])<<8 + int(p[1])
  799. sa.ZoneId = pp.Scope_id
  800. for i := 0; i < len(sa.Addr); i++ {
  801. sa.Addr[i] = pp.Addr[i]
  802. }
  803. return sa, nil
  804. }
  805. return nil, syscall.EAFNOSUPPORT
  806. }
  807. func Socket(domain, typ, proto int) (fd Handle, err error) {
  808. if domain == AF_INET6 && SocketDisableIPv6 {
  809. return InvalidHandle, syscall.EAFNOSUPPORT
  810. }
  811. return socket(int32(domain), int32(typ), int32(proto))
  812. }
  813. func SetsockoptInt(fd Handle, level, opt int, value int) (err error) {
  814. v := int32(value)
  815. return Setsockopt(fd, int32(level), int32(opt), (*byte)(unsafe.Pointer(&v)), int32(unsafe.Sizeof(v)))
  816. }
  817. func Bind(fd Handle, sa Sockaddr) (err error) {
  818. ptr, n, err := sa.sockaddr()
  819. if err != nil {
  820. return err
  821. }
  822. return bind(fd, ptr, n)
  823. }
  824. func Connect(fd Handle, sa Sockaddr) (err error) {
  825. ptr, n, err := sa.sockaddr()
  826. if err != nil {
  827. return err
  828. }
  829. return connect(fd, ptr, n)
  830. }
  831. func Getsockname(fd Handle) (sa Sockaddr, err error) {
  832. var rsa RawSockaddrAny
  833. l := int32(unsafe.Sizeof(rsa))
  834. if err = getsockname(fd, &rsa, &l); err != nil {
  835. return
  836. }
  837. return rsa.Sockaddr()
  838. }
  839. func Getpeername(fd Handle) (sa Sockaddr, err error) {
  840. var rsa RawSockaddrAny
  841. l := int32(unsafe.Sizeof(rsa))
  842. if err = getpeername(fd, &rsa, &l); err != nil {
  843. return
  844. }
  845. return rsa.Sockaddr()
  846. }
  847. func Listen(s Handle, n int) (err error) {
  848. return listen(s, int32(n))
  849. }
  850. func Shutdown(fd Handle, how int) (err error) {
  851. return shutdown(fd, int32(how))
  852. }
  853. func WSASendto(s Handle, bufs *WSABuf, bufcnt uint32, sent *uint32, flags uint32, to Sockaddr, overlapped *Overlapped, croutine *byte) (err error) {
  854. rsa, l, err := to.sockaddr()
  855. if err != nil {
  856. return err
  857. }
  858. return WSASendTo(s, bufs, bufcnt, sent, flags, (*RawSockaddrAny)(unsafe.Pointer(rsa)), l, overlapped, croutine)
  859. }
  860. func LoadGetAddrInfo() error {
  861. return procGetAddrInfoW.Find()
  862. }
  863. var connectExFunc struct {
  864. once sync.Once
  865. addr uintptr
  866. err error
  867. }
  868. func LoadConnectEx() error {
  869. connectExFunc.once.Do(func() {
  870. var s Handle
  871. s, connectExFunc.err = Socket(AF_INET, SOCK_STREAM, IPPROTO_TCP)
  872. if connectExFunc.err != nil {
  873. return
  874. }
  875. defer CloseHandle(s)
  876. var n uint32
  877. connectExFunc.err = WSAIoctl(s,
  878. SIO_GET_EXTENSION_FUNCTION_POINTER,
  879. (*byte)(unsafe.Pointer(&WSAID_CONNECTEX)),
  880. uint32(unsafe.Sizeof(WSAID_CONNECTEX)),
  881. (*byte)(unsafe.Pointer(&connectExFunc.addr)),
  882. uint32(unsafe.Sizeof(connectExFunc.addr)),
  883. &n, nil, 0)
  884. })
  885. return connectExFunc.err
  886. }
  887. func connectEx(s Handle, name unsafe.Pointer, namelen int32, sendBuf *byte, sendDataLen uint32, bytesSent *uint32, overlapped *Overlapped) (err error) {
  888. 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)
  889. if r1 == 0 {
  890. if e1 != 0 {
  891. err = error(e1)
  892. } else {
  893. err = syscall.EINVAL
  894. }
  895. }
  896. return
  897. }
  898. func ConnectEx(fd Handle, sa Sockaddr, sendBuf *byte, sendDataLen uint32, bytesSent *uint32, overlapped *Overlapped) error {
  899. err := LoadConnectEx()
  900. if err != nil {
  901. return errorspkg.New("failed to find ConnectEx: " + err.Error())
  902. }
  903. ptr, n, err := sa.sockaddr()
  904. if err != nil {
  905. return err
  906. }
  907. return connectEx(fd, ptr, n, sendBuf, sendDataLen, bytesSent, overlapped)
  908. }
  909. var sendRecvMsgFunc struct {
  910. once sync.Once
  911. sendAddr uintptr
  912. recvAddr uintptr
  913. err error
  914. }
  915. func loadWSASendRecvMsg() error {
  916. sendRecvMsgFunc.once.Do(func() {
  917. var s Handle
  918. s, sendRecvMsgFunc.err = Socket(AF_INET, SOCK_DGRAM, IPPROTO_UDP)
  919. if sendRecvMsgFunc.err != nil {
  920. return
  921. }
  922. defer CloseHandle(s)
  923. var n uint32
  924. sendRecvMsgFunc.err = WSAIoctl(s,
  925. SIO_GET_EXTENSION_FUNCTION_POINTER,
  926. (*byte)(unsafe.Pointer(&WSAID_WSARECVMSG)),
  927. uint32(unsafe.Sizeof(WSAID_WSARECVMSG)),
  928. (*byte)(unsafe.Pointer(&sendRecvMsgFunc.recvAddr)),
  929. uint32(unsafe.Sizeof(sendRecvMsgFunc.recvAddr)),
  930. &n, nil, 0)
  931. if sendRecvMsgFunc.err != nil {
  932. return
  933. }
  934. sendRecvMsgFunc.err = WSAIoctl(s,
  935. SIO_GET_EXTENSION_FUNCTION_POINTER,
  936. (*byte)(unsafe.Pointer(&WSAID_WSASENDMSG)),
  937. uint32(unsafe.Sizeof(WSAID_WSASENDMSG)),
  938. (*byte)(unsafe.Pointer(&sendRecvMsgFunc.sendAddr)),
  939. uint32(unsafe.Sizeof(sendRecvMsgFunc.sendAddr)),
  940. &n, nil, 0)
  941. })
  942. return sendRecvMsgFunc.err
  943. }
  944. func WSASendMsg(fd Handle, msg *WSAMsg, flags uint32, bytesSent *uint32, overlapped *Overlapped, croutine *byte) error {
  945. err := loadWSASendRecvMsg()
  946. if err != nil {
  947. return err
  948. }
  949. 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)))
  950. if r1 == socket_error {
  951. if e1 != 0 {
  952. err = errnoErr(e1)
  953. } else {
  954. err = syscall.EINVAL
  955. }
  956. }
  957. return err
  958. }
  959. func WSARecvMsg(fd Handle, msg *WSAMsg, bytesReceived *uint32, overlapped *Overlapped, croutine *byte) error {
  960. err := loadWSASendRecvMsg()
  961. if err != nil {
  962. return err
  963. }
  964. 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)
  965. if r1 == socket_error {
  966. if e1 != 0 {
  967. err = errnoErr(e1)
  968. } else {
  969. err = syscall.EINVAL
  970. }
  971. }
  972. return err
  973. }
  974. // Invented structures to support what package os expects.
  975. type Rusage struct {
  976. CreationTime Filetime
  977. ExitTime Filetime
  978. KernelTime Filetime
  979. UserTime Filetime
  980. }
  981. type WaitStatus struct {
  982. ExitCode uint32
  983. }
  984. func (w WaitStatus) Exited() bool { return true }
  985. func (w WaitStatus) ExitStatus() int { return int(w.ExitCode) }
  986. func (w WaitStatus) Signal() Signal { return -1 }
  987. func (w WaitStatus) CoreDump() bool { return false }
  988. func (w WaitStatus) Stopped() bool { return false }
  989. func (w WaitStatus) Continued() bool { return false }
  990. func (w WaitStatus) StopSignal() Signal { return -1 }
  991. func (w WaitStatus) Signaled() bool { return false }
  992. func (w WaitStatus) TrapCause() int { return -1 }
  993. // Timespec is an invented structure on Windows, but here for
  994. // consistency with the corresponding package for other operating systems.
  995. type Timespec struct {
  996. Sec int64
  997. Nsec int64
  998. }
  999. func TimespecToNsec(ts Timespec) int64 { return int64(ts.Sec)*1e9 + int64(ts.Nsec) }
  1000. func NsecToTimespec(nsec int64) (ts Timespec) {
  1001. ts.Sec = nsec / 1e9
  1002. ts.Nsec = nsec % 1e9
  1003. return
  1004. }
  1005. // TODO(brainman): fix all needed for net
  1006. func Accept(fd Handle) (nfd Handle, sa Sockaddr, err error) { return 0, nil, syscall.EWINDOWS }
  1007. func Recvfrom(fd Handle, p []byte, flags int) (n int, from Sockaddr, err error) {
  1008. return 0, nil, syscall.EWINDOWS
  1009. }
  1010. func Sendto(fd Handle, p []byte, flags int, to Sockaddr) (err error) { return syscall.EWINDOWS }
  1011. func SetsockoptTimeval(fd Handle, level, opt int, tv *Timeval) (err error) { return syscall.EWINDOWS }
  1012. // The Linger struct is wrong but we only noticed after Go 1.
  1013. // sysLinger is the real system call structure.
  1014. // BUG(brainman): The definition of Linger is not appropriate for direct use
  1015. // with Setsockopt and Getsockopt.
  1016. // Use SetsockoptLinger instead.
  1017. type Linger struct {
  1018. Onoff int32
  1019. Linger int32
  1020. }
  1021. type sysLinger struct {
  1022. Onoff uint16
  1023. Linger uint16
  1024. }
  1025. type IPMreq struct {
  1026. Multiaddr [4]byte /* in_addr */
  1027. Interface [4]byte /* in_addr */
  1028. }
  1029. type IPv6Mreq struct {
  1030. Multiaddr [16]byte /* in6_addr */
  1031. Interface uint32
  1032. }
  1033. func GetsockoptInt(fd Handle, level, opt int) (int, error) { return -1, syscall.EWINDOWS }
  1034. func SetsockoptLinger(fd Handle, level, opt int, l *Linger) (err error) {
  1035. sys := sysLinger{Onoff: uint16(l.Onoff), Linger: uint16(l.Linger)}
  1036. return Setsockopt(fd, int32(level), int32(opt), (*byte)(unsafe.Pointer(&sys)), int32(unsafe.Sizeof(sys)))
  1037. }
  1038. func SetsockoptInet4Addr(fd Handle, level, opt int, value [4]byte) (err error) {
  1039. return Setsockopt(fd, int32(level), int32(opt), (*byte)(unsafe.Pointer(&value[0])), 4)
  1040. }
  1041. func SetsockoptIPMreq(fd Handle, level, opt int, mreq *IPMreq) (err error) {
  1042. return Setsockopt(fd, int32(level), int32(opt), (*byte)(unsafe.Pointer(mreq)), int32(unsafe.Sizeof(*mreq)))
  1043. }
  1044. func SetsockoptIPv6Mreq(fd Handle, level, opt int, mreq *IPv6Mreq) (err error) {
  1045. return syscall.EWINDOWS
  1046. }
  1047. func Getpid() (pid int) { return int(GetCurrentProcessId()) }
  1048. func FindFirstFile(name *uint16, data *Win32finddata) (handle Handle, err error) {
  1049. // NOTE(rsc): The Win32finddata struct is wrong for the system call:
  1050. // the two paths are each one uint16 short. Use the correct struct,
  1051. // a win32finddata1, and then copy the results out.
  1052. // There is no loss of expressivity here, because the final
  1053. // uint16, if it is used, is supposed to be a NUL, and Go doesn't need that.
  1054. // For Go 1.1, we might avoid the allocation of win32finddata1 here
  1055. // by adding a final Bug [2]uint16 field to the struct and then
  1056. // adjusting the fields in the result directly.
  1057. var data1 win32finddata1
  1058. handle, err = findFirstFile1(name, &data1)
  1059. if err == nil {
  1060. copyFindData(data, &data1)
  1061. }
  1062. return
  1063. }
  1064. func FindNextFile(handle Handle, data *Win32finddata) (err error) {
  1065. var data1 win32finddata1
  1066. err = findNextFile1(handle, &data1)
  1067. if err == nil {
  1068. copyFindData(data, &data1)
  1069. }
  1070. return
  1071. }
  1072. func getProcessEntry(pid int) (*ProcessEntry32, error) {
  1073. snapshot, err := CreateToolhelp32Snapshot(TH32CS_SNAPPROCESS, 0)
  1074. if err != nil {
  1075. return nil, err
  1076. }
  1077. defer CloseHandle(snapshot)
  1078. var procEntry ProcessEntry32
  1079. procEntry.Size = uint32(unsafe.Sizeof(procEntry))
  1080. if err = Process32First(snapshot, &procEntry); err != nil {
  1081. return nil, err
  1082. }
  1083. for {
  1084. if procEntry.ProcessID == uint32(pid) {
  1085. return &procEntry, nil
  1086. }
  1087. err = Process32Next(snapshot, &procEntry)
  1088. if err != nil {
  1089. return nil, err
  1090. }
  1091. }
  1092. }
  1093. func Getppid() (ppid int) {
  1094. pe, err := getProcessEntry(Getpid())
  1095. if err != nil {
  1096. return -1
  1097. }
  1098. return int(pe.ParentProcessID)
  1099. }
  1100. // TODO(brainman): fix all needed for os
  1101. func Fchdir(fd Handle) (err error) { return syscall.EWINDOWS }
  1102. func Link(oldpath, newpath string) (err error) { return syscall.EWINDOWS }
  1103. func Symlink(path, link string) (err error) { return syscall.EWINDOWS }
  1104. func Fchmod(fd Handle, mode uint32) (err error) { return syscall.EWINDOWS }
  1105. func Chown(path string, uid int, gid int) (err error) { return syscall.EWINDOWS }
  1106. func Lchown(path string, uid int, gid int) (err error) { return syscall.EWINDOWS }
  1107. func Fchown(fd Handle, uid int, gid int) (err error) { return syscall.EWINDOWS }
  1108. func Getuid() (uid int) { return -1 }
  1109. func Geteuid() (euid int) { return -1 }
  1110. func Getgid() (gid int) { return -1 }
  1111. func Getegid() (egid int) { return -1 }
  1112. func Getgroups() (gids []int, err error) { return nil, syscall.EWINDOWS }
  1113. type Signal int
  1114. func (s Signal) Signal() {}
  1115. func (s Signal) String() string {
  1116. if 0 <= s && int(s) < len(signals) {
  1117. str := signals[s]
  1118. if str != "" {
  1119. return str
  1120. }
  1121. }
  1122. return "signal " + itoa(int(s))
  1123. }
  1124. func LoadCreateSymbolicLink() error {
  1125. return procCreateSymbolicLinkW.Find()
  1126. }
  1127. // Readlink returns the destination of the named symbolic link.
  1128. func Readlink(path string, buf []byte) (n int, err error) {
  1129. fd, err := CreateFile(StringToUTF16Ptr(path), GENERIC_READ, 0, nil, OPEN_EXISTING,
  1130. FILE_FLAG_OPEN_REPARSE_POINT|FILE_FLAG_BACKUP_SEMANTICS, 0)
  1131. if err != nil {
  1132. return -1, err
  1133. }
  1134. defer CloseHandle(fd)
  1135. rdbbuf := make([]byte, MAXIMUM_REPARSE_DATA_BUFFER_SIZE)
  1136. var bytesReturned uint32
  1137. err = DeviceIoControl(fd, FSCTL_GET_REPARSE_POINT, nil, 0, &rdbbuf[0], uint32(len(rdbbuf)), &bytesReturned, nil)
  1138. if err != nil {
  1139. return -1, err
  1140. }
  1141. rdb := (*reparseDataBuffer)(unsafe.Pointer(&rdbbuf[0]))
  1142. var s string
  1143. switch rdb.ReparseTag {
  1144. case IO_REPARSE_TAG_SYMLINK:
  1145. data := (*symbolicLinkReparseBuffer)(unsafe.Pointer(&rdb.reparseBuffer))
  1146. p := (*[0xffff]uint16)(unsafe.Pointer(&data.PathBuffer[0]))
  1147. s = UTF16ToString(p[data.PrintNameOffset/2 : (data.PrintNameLength-data.PrintNameOffset)/2])
  1148. case IO_REPARSE_TAG_MOUNT_POINT:
  1149. data := (*mountPointReparseBuffer)(unsafe.Pointer(&rdb.reparseBuffer))
  1150. p := (*[0xffff]uint16)(unsafe.Pointer(&data.PathBuffer[0]))
  1151. s = UTF16ToString(p[data.PrintNameOffset/2 : (data.PrintNameLength-data.PrintNameOffset)/2])
  1152. default:
  1153. // the path is not a symlink or junction but another type of reparse
  1154. // point
  1155. return -1, syscall.ENOENT
  1156. }
  1157. n = copy(buf, []byte(s))
  1158. return n, nil
  1159. }
  1160. // GUIDFromString parses a string in the form of
  1161. // "{XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}" into a GUID.
  1162. func GUIDFromString(str string) (GUID, error) {
  1163. guid := GUID{}
  1164. str16, err := syscall.UTF16PtrFromString(str)
  1165. if err != nil {
  1166. return guid, err
  1167. }
  1168. err = clsidFromString(str16, &guid)
  1169. if err != nil {
  1170. return guid, err
  1171. }
  1172. return guid, nil
  1173. }
  1174. // GenerateGUID creates a new random GUID.
  1175. func GenerateGUID() (GUID, error) {
  1176. guid := GUID{}
  1177. err := coCreateGuid(&guid)
  1178. if err != nil {
  1179. return guid, err
  1180. }
  1181. return guid, nil
  1182. }
  1183. // String returns the canonical string form of the GUID,
  1184. // in the form of "{XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}".
  1185. func (guid GUID) String() string {
  1186. var str [100]uint16
  1187. chars := stringFromGUID2(&guid, &str[0], int32(len(str)))
  1188. if chars <= 1 {
  1189. return ""
  1190. }
  1191. return string(utf16.Decode(str[:chars-1]))
  1192. }
  1193. // KnownFolderPath returns a well-known folder path for the current user, specified by one of
  1194. // the FOLDERID_ constants, and chosen and optionally created based on a KF_ flag.
  1195. func KnownFolderPath(folderID *KNOWNFOLDERID, flags uint32) (string, error) {
  1196. return Token(0).KnownFolderPath(folderID, flags)
  1197. }
  1198. // KnownFolderPath returns a well-known folder path for the user token, specified by one of
  1199. // the FOLDERID_ constants, and chosen and optionally created based on a KF_ flag.
  1200. func (t Token) KnownFolderPath(folderID *KNOWNFOLDERID, flags uint32) (string, error) {
  1201. var p *uint16
  1202. err := shGetKnownFolderPath(folderID, flags, t, &p)
  1203. if err != nil {
  1204. return "", err
  1205. }
  1206. defer CoTaskMemFree(unsafe.Pointer(p))
  1207. return UTF16ToString((*[(1 << 30) - 1]uint16)(unsafe.Pointer(p))[:]), nil
  1208. }
  1209. // RtlGetVersion returns the version of the underlying operating system, ignoring
  1210. // manifest semantics but is affected by the application compatibility layer.
  1211. func RtlGetVersion() *OsVersionInfoEx {
  1212. info := &OsVersionInfoEx{}
  1213. info.osVersionInfoSize = uint32(unsafe.Sizeof(*info))
  1214. // According to documentation, this function always succeeds.
  1215. // The function doesn't even check the validity of the
  1216. // osVersionInfoSize member. Disassembling ntdll.dll indicates
  1217. // that the documentation is indeed correct about that.
  1218. _ = rtlGetVersion(info)
  1219. return info
  1220. }
  1221. // RtlGetNtVersionNumbers returns the version of the underlying operating system,
  1222. // ignoring manifest semantics and the application compatibility layer.
  1223. func RtlGetNtVersionNumbers() (majorVersion, minorVersion, buildNumber uint32) {
  1224. rtlGetNtVersionNumbers(&majorVersion, &minorVersion, &buildNumber)
  1225. buildNumber &= 0xffff
  1226. return
  1227. }