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