{- |
Copyright  : Will Thompson, Iñaki García Etxebarria and Jonas Platte
License    : LGPL-2.1
Maintainer : Iñaki García Etxebarria (garetxe@gmail.com)
-}

#define ENABLE_OVERLOADING (MIN_VERSION_haskell_gi_overloading(1,0,0) \
       && !defined(__HADDOCK_VERSION__))

module GI.Gio.Functions
    (

 -- * Methods
-- ** busGet #method:busGet#

    busGet                                  ,


-- ** busGetFinish #method:busGetFinish#

    busGetFinish                            ,


-- ** busGetSync #method:busGetSync#

    busGetSync                              ,


-- ** busOwnName #method:busOwnName#

    busOwnName                              ,


-- ** busOwnNameOnConnection #method:busOwnNameOnConnection#

    busOwnNameOnConnection                  ,


-- ** busUnownName #method:busUnownName#

    busUnownName                            ,


-- ** busUnwatchName #method:busUnwatchName#

    busUnwatchName                          ,


-- ** busWatchName #method:busWatchName#

    busWatchName                            ,


-- ** busWatchNameOnConnection #method:busWatchNameOnConnection#

    busWatchNameOnConnection                ,


-- ** contentTypeCanBeExecutable #method:contentTypeCanBeExecutable#

    contentTypeCanBeExecutable              ,


-- ** contentTypeEquals #method:contentTypeEquals#

    contentTypeEquals                       ,


-- ** contentTypeFromMimeType #method:contentTypeFromMimeType#

    contentTypeFromMimeType                 ,


-- ** contentTypeGetDescription #method:contentTypeGetDescription#

    contentTypeGetDescription               ,


-- ** contentTypeGetGenericIconName #method:contentTypeGetGenericIconName#

    contentTypeGetGenericIconName           ,


-- ** contentTypeGetIcon #method:contentTypeGetIcon#

    contentTypeGetIcon                      ,


-- ** contentTypeGetMimeType #method:contentTypeGetMimeType#

    contentTypeGetMimeType                  ,


-- ** contentTypeGetSymbolicIcon #method:contentTypeGetSymbolicIcon#

    contentTypeGetSymbolicIcon              ,


-- ** contentTypeGuess #method:contentTypeGuess#

    contentTypeGuess                        ,


-- ** contentTypeGuessForTree #method:contentTypeGuessForTree#

    contentTypeGuessForTree                 ,


-- ** contentTypeIsA #method:contentTypeIsA#

    contentTypeIsA                          ,


-- ** contentTypeIsMimeType #method:contentTypeIsMimeType#

    contentTypeIsMimeType                   ,


-- ** contentTypeIsUnknown #method:contentTypeIsUnknown#

    contentTypeIsUnknown                    ,


-- ** contentTypesGetRegistered #method:contentTypesGetRegistered#

    contentTypesGetRegistered               ,


-- ** dbusAddressEscapeValue #method:dbusAddressEscapeValue#

    dbusAddressEscapeValue                  ,


-- ** dbusAddressGetForBusSync #method:dbusAddressGetForBusSync#

    dbusAddressGetForBusSync                ,


-- ** dbusAddressGetStream #method:dbusAddressGetStream#

    dbusAddressGetStream                    ,


-- ** dbusAddressGetStreamFinish #method:dbusAddressGetStreamFinish#

    dbusAddressGetStreamFinish              ,


-- ** dbusAddressGetStreamSync #method:dbusAddressGetStreamSync#

    dbusAddressGetStreamSync                ,


-- ** dbusGenerateGuid #method:dbusGenerateGuid#

    dbusGenerateGuid                        ,


-- ** dbusGvalueToGvariant #method:dbusGvalueToGvariant#

    dbusGvalueToGvariant                    ,


-- ** dbusGvariantToGvalue #method:dbusGvariantToGvalue#

    dbusGvariantToGvalue                    ,


-- ** dbusIsAddress #method:dbusIsAddress#

    dbusIsAddress                           ,


-- ** dbusIsGuid #method:dbusIsGuid#

    dbusIsGuid                              ,


-- ** dbusIsInterfaceName #method:dbusIsInterfaceName#

    dbusIsInterfaceName                     ,


-- ** dbusIsMemberName #method:dbusIsMemberName#

    dbusIsMemberName                        ,


-- ** dbusIsName #method:dbusIsName#

    dbusIsName                              ,


-- ** dbusIsSupportedAddress #method:dbusIsSupportedAddress#

    dbusIsSupportedAddress                  ,


-- ** dbusIsUniqueName #method:dbusIsUniqueName#

    dbusIsUniqueName                        ,


-- ** ioErrorFromErrno #method:ioErrorFromErrno#

    ioErrorFromErrno                        ,


-- ** ioErrorQuark #method:ioErrorQuark#

    ioErrorQuark                            ,


-- ** ioModulesScanAllInDirectory #method:ioModulesScanAllInDirectory#

    ioModulesScanAllInDirectory             ,


-- ** ioModulesScanAllInDirectoryWithScope #method:ioModulesScanAllInDirectoryWithScope#

    ioModulesScanAllInDirectoryWithScope    ,


-- ** ioSchedulerCancelAllJobs #method:ioSchedulerCancelAllJobs#

    ioSchedulerCancelAllJobs                ,


-- ** ioSchedulerPushJob #method:ioSchedulerPushJob#

    ioSchedulerPushJob                      ,


-- ** keyfileSettingsBackendNew #method:keyfileSettingsBackendNew#

    keyfileSettingsBackendNew               ,


-- ** memorySettingsBackendNew #method:memorySettingsBackendNew#

    memorySettingsBackendNew                ,


-- ** networkingInit #method:networkingInit#

    networkingInit                          ,


-- ** nullSettingsBackendNew #method:nullSettingsBackendNew#

    nullSettingsBackendNew                  ,


-- ** pollableSourceNew #method:pollableSourceNew#

    pollableSourceNew                       ,


-- ** pollableSourceNewFull #method:pollableSourceNewFull#

    pollableSourceNewFull                   ,


-- ** pollableStreamRead #method:pollableStreamRead#

    pollableStreamRead                      ,


-- ** pollableStreamWrite #method:pollableStreamWrite#

    pollableStreamWrite                     ,


-- ** pollableStreamWriteAll #method:pollableStreamWriteAll#

    pollableStreamWriteAll                  ,


-- ** resourcesEnumerateChildren #method:resourcesEnumerateChildren#

    resourcesEnumerateChildren              ,


-- ** resourcesGetInfo #method:resourcesGetInfo#

    resourcesGetInfo                        ,


-- ** resourcesLookupData #method:resourcesLookupData#

    resourcesLookupData                     ,


-- ** resourcesOpenStream #method:resourcesOpenStream#

    resourcesOpenStream                     ,


-- ** resourcesRegister #method:resourcesRegister#

    resourcesRegister                       ,


-- ** resourcesUnregister #method:resourcesUnregister#

    resourcesUnregister                     ,


-- ** simpleAsyncReportGerrorInIdle #method:simpleAsyncReportGerrorInIdle#

    simpleAsyncReportGerrorInIdle           ,


-- ** unixIsMountPathSystemInternal #method:unixIsMountPathSystemInternal#

    unixIsMountPathSystemInternal           ,


-- ** unixIsSystemDevicePath #method:unixIsSystemDevicePath#

    unixIsSystemDevicePath                  ,


-- ** unixIsSystemFsType #method:unixIsSystemFsType#

    unixIsSystemFsType                      ,


-- ** unixMountAt #method:unixMountAt#

    unixMountAt                             ,


-- ** unixMountCompare #method:unixMountCompare#

    unixMountCompare                        ,


-- ** unixMountCopy #method:unixMountCopy#

    unixMountCopy                           ,


-- ** unixMountFor #method:unixMountFor#

    unixMountFor                            ,


-- ** unixMountFree #method:unixMountFree#

    unixMountFree                           ,


-- ** unixMountGetDevicePath #method:unixMountGetDevicePath#

    unixMountGetDevicePath                  ,


-- ** unixMountGetFsType #method:unixMountGetFsType#

    unixMountGetFsType                      ,


-- ** unixMountGetMountPath #method:unixMountGetMountPath#

    unixMountGetMountPath                   ,


-- ** unixMountGuessCanEject #method:unixMountGuessCanEject#

    unixMountGuessCanEject                  ,


-- ** unixMountGuessIcon #method:unixMountGuessIcon#

    unixMountGuessIcon                      ,


-- ** unixMountGuessName #method:unixMountGuessName#

    unixMountGuessName                      ,


-- ** unixMountGuessShouldDisplay #method:unixMountGuessShouldDisplay#

    unixMountGuessShouldDisplay             ,


-- ** unixMountGuessSymbolicIcon #method:unixMountGuessSymbolicIcon#

    unixMountGuessSymbolicIcon              ,


-- ** unixMountIsReadonly #method:unixMountIsReadonly#

    unixMountIsReadonly                     ,


-- ** unixMountIsSystemInternal #method:unixMountIsSystemInternal#

    unixMountIsSystemInternal               ,


-- ** unixMountPointsChangedSince #method:unixMountPointsChangedSince#

    unixMountPointsChangedSince             ,


-- ** unixMountPointsGet #method:unixMountPointsGet#

    unixMountPointsGet                      ,


-- ** unixMountsChangedSince #method:unixMountsChangedSince#

    unixMountsChangedSince                  ,


-- ** unixMountsGet #method:unixMountsGet#

    unixMountsGet                           ,




    ) where

import Data.GI.Base.ShortPrelude
import qualified Data.GI.Base.ShortPrelude as SP
import qualified Data.GI.Base.Overloading as O
import qualified Prelude as P

import qualified Data.GI.Base.Attributes as GI.Attributes
import qualified Data.GI.Base.ManagedPtr as B.ManagedPtr
import qualified Data.GI.Base.GError as B.GError
import qualified Data.GI.Base.GVariant as B.GVariant
import qualified Data.GI.Base.GValue as B.GValue
import qualified Data.GI.Base.GParamSpec as B.GParamSpec
import qualified Data.GI.Base.CallStack as B.CallStack
import qualified Data.Text as T
import qualified Data.ByteString.Char8 as B
import qualified Data.Map as Map
import qualified Foreign.Ptr as FP

import qualified GI.GLib.Callbacks as GLib.Callbacks
import qualified GI.GLib.Structs.Bytes as GLib.Bytes
import qualified GI.GLib.Structs.Source as GLib.Source
import qualified GI.GLib.Structs.VariantType as GLib.VariantType
import qualified GI.GObject.Objects.Object as GObject.Object
import qualified GI.Gio.Callbacks as Gio.Callbacks
import {-# SOURCE #-} qualified GI.Gio.Enums as Gio.Enums
import {-# SOURCE #-} qualified GI.Gio.Flags as Gio.Flags
import {-# SOURCE #-} qualified GI.Gio.Interfaces.AsyncResult as Gio.AsyncResult
import {-# SOURCE #-} qualified GI.Gio.Interfaces.File as Gio.File
import {-# SOURCE #-} qualified GI.Gio.Interfaces.Icon as Gio.Icon
import {-# SOURCE #-} qualified GI.Gio.Objects.Cancellable as Gio.Cancellable
import {-# SOURCE #-} qualified GI.Gio.Objects.DBusConnection as Gio.DBusConnection
import {-# SOURCE #-} qualified GI.Gio.Objects.IOStream as Gio.IOStream
import {-# SOURCE #-} qualified GI.Gio.Objects.InputStream as Gio.InputStream
import {-# SOURCE #-} qualified GI.Gio.Objects.OutputStream as Gio.OutputStream
import {-# SOURCE #-} qualified GI.Gio.Objects.SettingsBackend as Gio.SettingsBackend
import {-# SOURCE #-} qualified GI.Gio.Structs.IOModuleScope as Gio.IOModuleScope
import {-# SOURCE #-} qualified GI.Gio.Structs.Resource as Gio.Resource
import {-# SOURCE #-} qualified GI.Gio.Structs.UnixMountEntry as Gio.UnixMountEntry
import {-# SOURCE #-} qualified GI.Gio.Structs.UnixMountPoint as Gio.UnixMountPoint

-- function g_unix_mounts_get
-- Args : [Arg {argCName = "time_read", argType = TBasicType TUInt64, direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "guint64 to contain a timestamp, or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferEverything}]
-- Lengths : []
-- returnType : Just (TGList (TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})))
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mounts_get" g_unix_mounts_get ::
    Ptr Word64 ->                           -- time_read : TBasicType TUInt64
    IO (Ptr (GList (Ptr Gio.UnixMountEntry.UnixMountEntry)))

{- |
Gets a 'GI.GLib.Structs.List.List' of 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry' containing the unix mounts.
If /@timeRead@/ is set, it will be filled with the mount
timestamp, allowing for checking if the mounts have changed
with 'GI.Gio.Functions.unixMountsChangedSince'.
-}
unixMountsGet ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    m (([Gio.UnixMountEntry.UnixMountEntry], Word64))
    {- ^ __Returns:__ 
    a 'GI.GLib.Structs.List.List' of the UNIX mounts. -}
unixMountsGet  = liftIO $ do
    timeRead <- allocMem :: IO (Ptr Word64)
    result <- g_unix_mounts_get timeRead
    result' <- unpackGList result
    result'' <- mapM (wrapBoxed Gio.UnixMountEntry.UnixMountEntry) result'
    g_list_free result
    timeRead' <- peek timeRead
    freeMem timeRead
    return (result'', timeRead')


-- function g_unix_mounts_changed_since
-- Args : [Arg {argCName = "time", argType = TBasicType TUInt64, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "guint64 to contain a timestamp.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mounts_changed_since" g_unix_mounts_changed_since ::
    Word64 ->                               -- time : TBasicType TUInt64
    IO CInt

{- |
Checks if the unix mounts have changed since a given unix time.
-}
unixMountsChangedSince ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Word64
    {- ^ /@time@/: guint64 to contain a timestamp. -}
    -> m Bool
    {- ^ __Returns:__ 'True' if the mounts have changed since /@time@/. -}
unixMountsChangedSince time = liftIO $ do
    result <- g_unix_mounts_changed_since time
    let result' = (/= 0) result
    return result'


-- function g_unix_mount_points_get
-- Args : [Arg {argCName = "time_read", argType = TBasicType TUInt64, direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "guint64 to contain a timestamp.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferEverything}]
-- Lengths : []
-- returnType : Just (TGList (TInterface (Name {namespace = "Gio", name = "UnixMountPoint"})))
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_points_get" g_unix_mount_points_get ::
    Ptr Word64 ->                           -- time_read : TBasicType TUInt64
    IO (Ptr (GList (Ptr Gio.UnixMountPoint.UnixMountPoint)))

{- |
Gets a 'GI.GLib.Structs.List.List' of 'GI.Gio.Structs.UnixMountPoint.UnixMountPoint' containing the unix mount points.
If /@timeRead@/ is set, it will be filled with the mount timestamp,
allowing for checking if the mounts have changed with
'GI.Gio.Functions.unixMountPointsChangedSince'.
-}
unixMountPointsGet ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    m (([Gio.UnixMountPoint.UnixMountPoint], Word64))
    {- ^ __Returns:__ 
    a 'GI.GLib.Structs.List.List' of the UNIX mountpoints. -}
unixMountPointsGet  = liftIO $ do
    timeRead <- allocMem :: IO (Ptr Word64)
    result <- g_unix_mount_points_get timeRead
    result' <- unpackGList result
    result'' <- mapM (wrapBoxed Gio.UnixMountPoint.UnixMountPoint) result'
    g_list_free result
    timeRead' <- peek timeRead
    freeMem timeRead
    return (result'', timeRead')


-- function g_unix_mount_points_changed_since
-- Args : [Arg {argCName = "time", argType = TBasicType TUInt64, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "guint64 to contain a timestamp.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_points_changed_since" g_unix_mount_points_changed_since ::
    Word64 ->                               -- time : TBasicType TUInt64
    IO CInt

{- |
Checks if the unix mount points have changed since a given unix time.
-}
unixMountPointsChangedSince ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Word64
    {- ^ /@time@/: guint64 to contain a timestamp. -}
    -> m Bool
    {- ^ __Returns:__ 'True' if the mount points have changed since /@time@/. -}
unixMountPointsChangedSince time = liftIO $ do
    result <- g_unix_mount_points_changed_since time
    let result' = (/= 0) result
    return result'


-- function g_unix_mount_is_system_internal
-- Args : [Arg {argCName = "mount_entry", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GUnixMount.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_is_system_internal" g_unix_mount_is_system_internal ::
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount_entry : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    IO CInt

{- |
Checks if a Unix mount is a system mount. This is the Boolean OR of
'GI.Gio.Functions.unixIsSystemFsType', 'GI.Gio.Functions.unixIsSystemDevicePath' and
'GI.Gio.Functions.unixIsMountPathSystemInternal' on /@mountEntry@/’s properties.

The definition of what a ‘system’ mount entry is may change over time as new
file system types and device paths are ignored.
-}
unixMountIsSystemInternal ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mountEntry@/: a @/GUnixMount/@. -}
    -> m Bool
    {- ^ __Returns:__ 'True' if the unix mount is for a system path. -}
unixMountIsSystemInternal mountEntry = liftIO $ do
    mountEntry' <- unsafeManagedPtrGetPtr mountEntry
    result <- g_unix_mount_is_system_internal mountEntry'
    let result' = (/= 0) result
    touchManagedPtr mountEntry
    return result'


-- function g_unix_mount_is_readonly
-- Args : [Arg {argCName = "mount_entry", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GUnixMount.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_is_readonly" g_unix_mount_is_readonly ::
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount_entry : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    IO CInt

{- |
Checks if a unix mount is mounted read only.
-}
unixMountIsReadonly ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mountEntry@/: a @/GUnixMount/@. -}
    -> m Bool
    {- ^ __Returns:__ 'True' if /@mountEntry@/ is read only. -}
unixMountIsReadonly mountEntry = liftIO $ do
    mountEntry' <- unsafeManagedPtrGetPtr mountEntry
    result <- g_unix_mount_is_readonly mountEntry'
    let result' = (/= 0) result
    touchManagedPtr mountEntry
    return result'


-- function g_unix_mount_guess_symbolic_icon
-- Args : [Arg {argCName = "mount_entry", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GUnixMountEntry", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "Icon"}))
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_guess_symbolic_icon" g_unix_mount_guess_symbolic_icon ::
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount_entry : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    IO (Ptr Gio.Icon.Icon)

{- |
Guesses the symbolic icon of a Unix mount.

/Since: 2.34/
-}
unixMountGuessSymbolicIcon ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mountEntry@/: a 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry' -}
    -> m Gio.Icon.Icon
    {- ^ __Returns:__ a 'GI.Gio.Interfaces.Icon.Icon' -}
unixMountGuessSymbolicIcon mountEntry = liftIO $ do
    mountEntry' <- unsafeManagedPtrGetPtr mountEntry
    result <- g_unix_mount_guess_symbolic_icon mountEntry'
    checkUnexpectedReturnNULL "unixMountGuessSymbolicIcon" result
    result' <- (wrapObject Gio.Icon.Icon) result
    touchManagedPtr mountEntry
    return result'


-- function g_unix_mount_guess_should_display
-- Args : [Arg {argCName = "mount_entry", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GUnixMountEntry", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_guess_should_display" g_unix_mount_guess_should_display ::
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount_entry : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    IO CInt

{- |
Guesses whether a Unix mount should be displayed in the UI.
-}
unixMountGuessShouldDisplay ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mountEntry@/: a 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry' -}
    -> m Bool
    {- ^ __Returns:__ 'True' if /@mountEntry@/ is deemed to be displayable. -}
unixMountGuessShouldDisplay mountEntry = liftIO $ do
    mountEntry' <- unsafeManagedPtrGetPtr mountEntry
    result <- g_unix_mount_guess_should_display mountEntry'
    let result' = (/= 0) result
    touchManagedPtr mountEntry
    return result'


-- function g_unix_mount_guess_name
-- Args : [Arg {argCName = "mount_entry", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GUnixMountEntry", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_guess_name" g_unix_mount_guess_name ::
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount_entry : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    IO CString

{- |
Guesses the name of a Unix mount.
The result is a translated string.
-}
unixMountGuessName ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mountEntry@/: a 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry' -}
    -> m T.Text
    {- ^ __Returns:__ A newly allocated string that must
    be freed with 'GI.GLib.Functions.free' -}
unixMountGuessName mountEntry = liftIO $ do
    mountEntry' <- unsafeManagedPtrGetPtr mountEntry
    result <- g_unix_mount_guess_name mountEntry'
    checkUnexpectedReturnNULL "unixMountGuessName" result
    result' <- cstringToText result
    freeMem result
    touchManagedPtr mountEntry
    return result'


-- function g_unix_mount_guess_icon
-- Args : [Arg {argCName = "mount_entry", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GUnixMountEntry", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "Icon"}))
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_guess_icon" g_unix_mount_guess_icon ::
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount_entry : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    IO (Ptr Gio.Icon.Icon)

{- |
Guesses the icon of a Unix mount.
-}
unixMountGuessIcon ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mountEntry@/: a 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry' -}
    -> m Gio.Icon.Icon
    {- ^ __Returns:__ a 'GI.Gio.Interfaces.Icon.Icon' -}
unixMountGuessIcon mountEntry = liftIO $ do
    mountEntry' <- unsafeManagedPtrGetPtr mountEntry
    result <- g_unix_mount_guess_icon mountEntry'
    checkUnexpectedReturnNULL "unixMountGuessIcon" result
    result' <- (wrapObject Gio.Icon.Icon) result
    touchManagedPtr mountEntry
    return result'


-- function g_unix_mount_guess_can_eject
-- Args : [Arg {argCName = "mount_entry", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GUnixMountEntry", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_guess_can_eject" g_unix_mount_guess_can_eject ::
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount_entry : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    IO CInt

{- |
Guesses whether a Unix mount can be ejected.
-}
unixMountGuessCanEject ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mountEntry@/: a 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry' -}
    -> m Bool
    {- ^ __Returns:__ 'True' if /@mountEntry@/ is deemed to be ejectable. -}
unixMountGuessCanEject mountEntry = liftIO $ do
    mountEntry' <- unsafeManagedPtrGetPtr mountEntry
    result <- g_unix_mount_guess_can_eject mountEntry'
    let result' = (/= 0) result
    touchManagedPtr mountEntry
    return result'


-- function g_unix_mount_get_mount_path
-- Args : [Arg {argCName = "mount_entry", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "input #GUnixMountEntry to get the mount path for.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TFileName)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_get_mount_path" g_unix_mount_get_mount_path ::
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount_entry : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    IO CString

{- |
Gets the mount path for a unix mount.
-}
unixMountGetMountPath ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mountEntry@/: input 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry' to get the mount path for. -}
    -> m [Char]
    {- ^ __Returns:__ the mount path for /@mountEntry@/. -}
unixMountGetMountPath mountEntry = liftIO $ do
    mountEntry' <- unsafeManagedPtrGetPtr mountEntry
    result <- g_unix_mount_get_mount_path mountEntry'
    checkUnexpectedReturnNULL "unixMountGetMountPath" result
    result' <- cstringToString result
    touchManagedPtr mountEntry
    return result'


-- function g_unix_mount_get_fs_type
-- Args : [Arg {argCName = "mount_entry", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GUnixMount.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_get_fs_type" g_unix_mount_get_fs_type ::
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount_entry : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    IO CString

{- |
Gets the filesystem type for the unix mount.
-}
unixMountGetFsType ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mountEntry@/: a @/GUnixMount/@. -}
    -> m T.Text
    {- ^ __Returns:__ a string containing the file system type. -}
unixMountGetFsType mountEntry = liftIO $ do
    mountEntry' <- unsafeManagedPtrGetPtr mountEntry
    result <- g_unix_mount_get_fs_type mountEntry'
    checkUnexpectedReturnNULL "unixMountGetFsType" result
    result' <- cstringToText result
    touchManagedPtr mountEntry
    return result'


-- function g_unix_mount_get_device_path
-- Args : [Arg {argCName = "mount_entry", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GUnixMount.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TFileName)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_get_device_path" g_unix_mount_get_device_path ::
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount_entry : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    IO CString

{- |
Gets the device path for a unix mount.
-}
unixMountGetDevicePath ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mountEntry@/: a @/GUnixMount/@. -}
    -> m [Char]
    {- ^ __Returns:__ a string containing the device path. -}
unixMountGetDevicePath mountEntry = liftIO $ do
    mountEntry' <- unsafeManagedPtrGetPtr mountEntry
    result <- g_unix_mount_get_device_path mountEntry'
    checkUnexpectedReturnNULL "unixMountGetDevicePath" result
    result' <- cstringToString result
    touchManagedPtr mountEntry
    return result'


-- function g_unix_mount_free
-- Args : [Arg {argCName = "mount_entry", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GUnixMountEntry.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_free" g_unix_mount_free ::
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount_entry : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    IO ()

{- |
Frees a unix mount.
-}
unixMountFree ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mountEntry@/: a 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry'. -}
    -> m ()
unixMountFree mountEntry = liftIO $ do
    mountEntry' <- unsafeManagedPtrGetPtr mountEntry
    g_unix_mount_free mountEntry'
    touchManagedPtr mountEntry
    return ()


-- function g_unix_mount_for
-- Args : [Arg {argCName = "file_path", argType = TBasicType TFileName, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "file path on some unix mount.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "time_read", argType = TBasicType TUInt64, direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "guint64 to contain a timestamp.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferEverything}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}))
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_for" g_unix_mount_for ::
    CString ->                              -- file_path : TBasicType TFileName
    Ptr Word64 ->                           -- time_read : TBasicType TUInt64
    IO (Ptr Gio.UnixMountEntry.UnixMountEntry)

{- |
Gets a 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry' for a given file path. If /@timeRead@/
is set, it will be filled with a unix timestamp for checking
if the mounts have changed since with 'GI.Gio.Functions.unixMountsChangedSince'.

/Since: 2.52/
-}
unixMountFor ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    [Char]
    {- ^ /@filePath@/: file path on some unix mount. -}
    -> m ((Gio.UnixMountEntry.UnixMountEntry, Word64))
    {- ^ __Returns:__ a 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry'. -}
unixMountFor filePath = liftIO $ do
    filePath' <- stringToCString filePath
    timeRead <- allocMem :: IO (Ptr Word64)
    result <- g_unix_mount_for filePath' timeRead
    checkUnexpectedReturnNULL "unixMountFor" result
    result' <- (wrapBoxed Gio.UnixMountEntry.UnixMountEntry) result
    timeRead' <- peek timeRead
    freeMem filePath'
    freeMem timeRead
    return (result', timeRead')


-- function g_unix_mount_copy
-- Args : [Arg {argCName = "mount_entry", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GUnixMountEntry.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}))
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_copy" g_unix_mount_copy ::
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount_entry : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    IO (Ptr Gio.UnixMountEntry.UnixMountEntry)

{- |
Makes a copy of /@mountEntry@/.

/Since: 2.54/
-}
unixMountCopy ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mountEntry@/: a 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry'. -}
    -> m Gio.UnixMountEntry.UnixMountEntry
    {- ^ __Returns:__ a new 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry' -}
unixMountCopy mountEntry = liftIO $ do
    mountEntry' <- unsafeManagedPtrGetPtr mountEntry
    result <- g_unix_mount_copy mountEntry'
    checkUnexpectedReturnNULL "unixMountCopy" result
    result' <- (wrapBoxed Gio.UnixMountEntry.UnixMountEntry) result
    touchManagedPtr mountEntry
    return result'


-- function g_unix_mount_compare
-- Args : [Arg {argCName = "mount1", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "first #GUnixMountEntry to compare.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "mount2", argType = TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "second #GUnixMountEntry to compare.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TInt)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_compare" g_unix_mount_compare ::
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount1 : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    Ptr Gio.UnixMountEntry.UnixMountEntry -> -- mount2 : TInterface (Name {namespace = "Gio", name = "UnixMountEntry"})
    IO Int32

{- |
Compares two unix mounts.
-}
unixMountCompare ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mount1@/: first 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry' to compare. -}
    -> Gio.UnixMountEntry.UnixMountEntry
    {- ^ /@mount2@/: second 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry' to compare. -}
    -> m Int32
    {- ^ __Returns:__ 1, 0 or -1 if /@mount1@/ is greater than, equal to,
or less than /@mount2@/, respectively. -}
unixMountCompare mount1 mount2 = liftIO $ do
    mount1' <- unsafeManagedPtrGetPtr mount1
    mount2' <- unsafeManagedPtrGetPtr mount2
    result <- g_unix_mount_compare mount1' mount2'
    touchManagedPtr mount1
    touchManagedPtr mount2
    return result


-- function g_unix_mount_at
-- Args : [Arg {argCName = "mount_path", argType = TBasicType TFileName, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "path for a possible unix mount.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "time_read", argType = TBasicType TUInt64, direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "guint64 to contain a timestamp.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferEverything}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "UnixMountEntry"}))
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_mount_at" g_unix_mount_at ::
    CString ->                              -- mount_path : TBasicType TFileName
    Ptr Word64 ->                           -- time_read : TBasicType TUInt64
    IO (Ptr Gio.UnixMountEntry.UnixMountEntry)

{- |
Gets a 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry' for a given mount path. If /@timeRead@/
is set, it will be filled with a unix timestamp for checking
if the mounts have changed since with 'GI.Gio.Functions.unixMountsChangedSince'.
-}
unixMountAt ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    [Char]
    {- ^ /@mountPath@/: path for a possible unix mount. -}
    -> m ((Gio.UnixMountEntry.UnixMountEntry, Word64))
    {- ^ __Returns:__ a 'GI.Gio.Structs.UnixMountEntry.UnixMountEntry'. -}
unixMountAt mountPath = liftIO $ do
    mountPath' <- stringToCString mountPath
    timeRead <- allocMem :: IO (Ptr Word64)
    result <- g_unix_mount_at mountPath' timeRead
    checkUnexpectedReturnNULL "unixMountAt" result
    result' <- (wrapBoxed Gio.UnixMountEntry.UnixMountEntry) result
    timeRead' <- peek timeRead
    freeMem mountPath'
    freeMem timeRead
    return (result', timeRead')


-- function g_unix_is_system_fs_type
-- Args : [Arg {argCName = "fs_type", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a file system type, e.g. `procfs` or `tmpfs`", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_is_system_fs_type" g_unix_is_system_fs_type ::
    CString ->                              -- fs_type : TBasicType TUTF8
    IO CInt

{- |
Determines if /@fsType@/ is considered a type of file system which is only
used in implementation of the OS. This is primarily used for hiding
mounted volumes that are intended as APIs for programs to read, and system
administrators at a shell; rather than something that should, for example,
appear in a GUI. For example, the Linux @\/proc@ filesystem.

The list of file system types considered ‘system’ ones may change over time.

/Since: 2.56/
-}
unixIsSystemFsType ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@fsType@/: a file system type, e.g. @procfs@ or @tmpfs@ -}
    -> m Bool
    {- ^ __Returns:__ 'True' if /@fsType@/ is considered an implementation detail of the OS. -}
unixIsSystemFsType fsType = liftIO $ do
    fsType' <- textToCString fsType
    result <- g_unix_is_system_fs_type fsType'
    let result' = (/= 0) result
    freeMem fsType'
    return result'


-- function g_unix_is_system_device_path
-- Args : [Arg {argCName = "device_path", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a device path, e.g. `/dev/loop0` or `nfsd`", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_is_system_device_path" g_unix_is_system_device_path ::
    CString ->                              -- device_path : TBasicType TUTF8
    IO CInt

{- |
Determines if /@devicePath@/ is considered a block device path which is only
used in implementation of the OS. This is primarily used for hiding
mounted volumes that are intended as APIs for programs to read, and system
administrators at a shell; rather than something that should, for example,
appear in a GUI. For example, the Linux @\/proc@ filesystem.

The list of device paths considered ‘system’ ones may change over time.

/Since: 2.56/
-}
unixIsSystemDevicePath ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@devicePath@/: a device path, e.g. @\/dev\/loop0@ or @nfsd@ -}
    -> m Bool
    {- ^ __Returns:__ 'True' if /@devicePath@/ is considered an implementation detail of
   the OS. -}
unixIsSystemDevicePath devicePath = liftIO $ do
    devicePath' <- textToCString devicePath
    result <- g_unix_is_system_device_path devicePath'
    let result' = (/= 0) result
    freeMem devicePath'
    return result'


-- function g_unix_is_mount_path_system_internal
-- Args : [Arg {argCName = "mount_path", argType = TBasicType TFileName, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a mount path, e.g. `/media/disk` or `/usr`", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_unix_is_mount_path_system_internal" g_unix_is_mount_path_system_internal ::
    CString ->                              -- mount_path : TBasicType TFileName
    IO CInt

{- |
Determines if /@mountPath@/ is considered an implementation of the
OS. This is primarily used for hiding mountable and mounted volumes
that only are used in the OS and has little to no relevance to the
casual user.
-}
unixIsMountPathSystemInternal ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    [Char]
    {- ^ /@mountPath@/: a mount path, e.g. @\/media\/disk@ or @\/usr@ -}
    -> m Bool
    {- ^ __Returns:__ 'True' if /@mountPath@/ is considered an implementation detail
    of the OS. -}
unixIsMountPathSystemInternal mountPath = liftIO $ do
    mountPath' <- stringToCString mountPath
    result <- g_unix_is_mount_path_system_internal mountPath'
    let result' = (/= 0) result
    freeMem mountPath'
    return result'


-- function g_simple_async_report_gerror_in_idle
-- Args : [Arg {argCName = "object", argType = TInterface (Name {namespace = "GObject", name = "Object"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "a #GObject, or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "callback", argType = TInterface (Name {namespace = "Gio", name = "AsyncReadyCallback"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "a #GAsyncReadyCallback.", sinceVersion = Nothing}, argScope = ScopeTypeAsync, argClosure = 2, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "user_data", argType = TBasicType TPtr, direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "user data passed to @callback.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "error", argType = TError, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the #GError to report", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_simple_async_report_gerror_in_idle" g_simple_async_report_gerror_in_idle ::
    Ptr GObject.Object.Object ->            -- object : TInterface (Name {namespace = "GObject", name = "Object"})
    FunPtr Gio.Callbacks.C_AsyncReadyCallback -> -- callback : TInterface (Name {namespace = "Gio", name = "AsyncReadyCallback"})
    Ptr () ->                               -- user_data : TBasicType TPtr
    Ptr GError ->                           -- error : TError
    IO ()

{-# DEPRECATED simpleAsyncReportGerrorInIdle ["(Since version 2.46)","Use 'GI.Gio.Objects.Task.taskReportError'."] #-}
{- |
Reports an error in an idle function. Similar to
@/g_simple_async_report_error_in_idle()/@, but takes a 'GError' rather
than building a new one.
-}
simpleAsyncReportGerrorInIdle ::
    (B.CallStack.HasCallStack, MonadIO m, GObject.Object.IsObject a) =>
    Maybe (a)
    {- ^ /@object@/: a 'GI.GObject.Objects.Object.Object', or 'Nothing' -}
    -> Maybe (Gio.Callbacks.AsyncReadyCallback)
    {- ^ /@callback@/: a 'GI.Gio.Callbacks.AsyncReadyCallback'. -}
    -> GError
    {- ^ /@error@/: the 'GError' to report -}
    -> m ()
simpleAsyncReportGerrorInIdle object callback error_ = liftIO $ do
    maybeObject <- case object of
        Nothing -> return nullPtr
        Just jObject -> do
            jObject' <- unsafeManagedPtrCastPtr jObject
            return jObject'
    maybeCallback <- case callback of
        Nothing -> return (castPtrToFunPtr nullPtr)
        Just jCallback -> do
            ptrcallback <- callocMem :: IO (Ptr (FunPtr Gio.Callbacks.C_AsyncReadyCallback))
            jCallback' <- Gio.Callbacks.mk_AsyncReadyCallback (Gio.Callbacks.wrap_AsyncReadyCallback (Just ptrcallback) (Gio.Callbacks.drop_closures_AsyncReadyCallback jCallback))
            poke ptrcallback jCallback'
            return jCallback'
    error_' <- unsafeManagedPtrGetPtr error_
    let userData = nullPtr
    g_simple_async_report_gerror_in_idle maybeObject maybeCallback userData error_'
    whenJust object touchManagedPtr
    touchManagedPtr error_
    return ()


-- function g_resources_unregister
-- Args : [Arg {argCName = "resource", argType = TInterface (Name {namespace = "Gio", name = "Resource"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A #GResource", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_resources_unregister" g_resources_unregister ::
    Ptr Gio.Resource.Resource ->            -- resource : TInterface (Name {namespace = "Gio", name = "Resource"})
    IO ()

{- |
Unregisters the resource from the process-global set of resources.

/Since: 2.32/
-}
resourcesUnregister ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.Resource.Resource
    {- ^ /@resource@/: A 'GI.Gio.Structs.Resource.Resource' -}
    -> m ()
resourcesUnregister resource = liftIO $ do
    resource' <- unsafeManagedPtrGetPtr resource
    g_resources_unregister resource'
    touchManagedPtr resource
    return ()


-- function g_resources_register
-- Args : [Arg {argCName = "resource", argType = TInterface (Name {namespace = "Gio", name = "Resource"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A #GResource", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_resources_register" g_resources_register ::
    Ptr Gio.Resource.Resource ->            -- resource : TInterface (Name {namespace = "Gio", name = "Resource"})
    IO ()

{- |
Registers the resource with the process-global set of resources.
Once a resource is registered the files in it can be accessed
with the global resource lookup functions like 'GI.Gio.Functions.resourcesLookupData'.

/Since: 2.32/
-}
resourcesRegister ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.Resource.Resource
    {- ^ /@resource@/: A 'GI.Gio.Structs.Resource.Resource' -}
    -> m ()
resourcesRegister resource = liftIO $ do
    resource' <- unsafeManagedPtrGetPtr resource
    g_resources_register resource'
    touchManagedPtr resource
    return ()


-- function g_resources_open_stream
-- Args : [Arg {argCName = "path", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A pathname inside the resource", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "lookup_flags", argType = TInterface (Name {namespace = "Gio", name = "ResourceLookupFlags"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A #GResourceLookupFlags", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "InputStream"}))
-- throws : True
-- Skip return : False

foreign import ccall "g_resources_open_stream" g_resources_open_stream ::
    CString ->                              -- path : TBasicType TUTF8
    CUInt ->                                -- lookup_flags : TInterface (Name {namespace = "Gio", name = "ResourceLookupFlags"})
    Ptr (Ptr GError) ->                     -- error
    IO (Ptr Gio.InputStream.InputStream)

{- |
Looks for a file at the specified /@path@/ in the set of
globally registered resources and returns a 'GI.Gio.Objects.InputStream.InputStream'
that lets you read the data.

/@lookupFlags@/ controls the behaviour of the lookup.

/Since: 2.32/
-}
resourcesOpenStream ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@path@/: A pathname inside the resource -}
    -> [Gio.Flags.ResourceLookupFlags]
    {- ^ /@lookupFlags@/: A 'GI.Gio.Flags.ResourceLookupFlags' -}
    -> m Gio.InputStream.InputStream
    {- ^ __Returns:__ 'GI.Gio.Objects.InputStream.InputStream' or 'Nothing' on error.
    Free the returned object with 'GI.GObject.Objects.Object.objectUnref' /(Can throw 'Data.GI.Base.GError.GError')/ -}
resourcesOpenStream path lookupFlags = liftIO $ do
    path' <- textToCString path
    let lookupFlags' = gflagsToWord lookupFlags
    onException (do
        result <- propagateGError $ g_resources_open_stream path' lookupFlags'
        checkUnexpectedReturnNULL "resourcesOpenStream" result
        result' <- (wrapObject Gio.InputStream.InputStream) result
        freeMem path'
        return result'
     ) (do
        freeMem path'
     )


-- function g_resources_lookup_data
-- Args : [Arg {argCName = "path", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A pathname inside the resource", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "lookup_flags", argType = TInterface (Name {namespace = "Gio", name = "ResourceLookupFlags"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A #GResourceLookupFlags", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "GLib", name = "Bytes"}))
-- throws : True
-- Skip return : False

foreign import ccall "g_resources_lookup_data" g_resources_lookup_data ::
    CString ->                              -- path : TBasicType TUTF8
    CUInt ->                                -- lookup_flags : TInterface (Name {namespace = "Gio", name = "ResourceLookupFlags"})
    Ptr (Ptr GError) ->                     -- error
    IO (Ptr GLib.Bytes.Bytes)

{- |
Looks for a file at the specified /@path@/ in the set of
globally registered resources and returns a 'GI.GLib.Structs.Bytes.Bytes' that
lets you directly access the data in memory.

The data is always followed by a zero byte, so you
can safely use the data as a C string. However, that byte
is not included in the size of the GBytes.

For uncompressed resource files this is a pointer directly into
the resource bundle, which is typically in some readonly data section
in the program binary. For compressed files we allocate memory on
the heap and automatically uncompress the data.

/@lookupFlags@/ controls the behaviour of the lookup.

/Since: 2.32/
-}
resourcesLookupData ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@path@/: A pathname inside the resource -}
    -> [Gio.Flags.ResourceLookupFlags]
    {- ^ /@lookupFlags@/: A 'GI.Gio.Flags.ResourceLookupFlags' -}
    -> m GLib.Bytes.Bytes
    {- ^ __Returns:__ 'GI.GLib.Structs.Bytes.Bytes' or 'Nothing' on error.
    Free the returned object with 'GI.GLib.Structs.Bytes.bytesUnref' /(Can throw 'Data.GI.Base.GError.GError')/ -}
resourcesLookupData path lookupFlags = liftIO $ do
    path' <- textToCString path
    let lookupFlags' = gflagsToWord lookupFlags
    onException (do
        result <- propagateGError $ g_resources_lookup_data path' lookupFlags'
        checkUnexpectedReturnNULL "resourcesLookupData" result
        result' <- (wrapBoxed GLib.Bytes.Bytes) result
        freeMem path'
        return result'
     ) (do
        freeMem path'
     )


-- function g_resources_get_info
-- Args : [Arg {argCName = "path", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A pathname inside the resource", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "lookup_flags", argType = TInterface (Name {namespace = "Gio", name = "ResourceLookupFlags"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A #GResourceLookupFlags", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "size", argType = TBasicType TUInt64, direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a location to place the length of the contents of the file,\n   or %NULL if the length is not needed", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferEverything},Arg {argCName = "flags", argType = TBasicType TUInt32, direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a location to place the #GResourceFlags about the file,\n   or %NULL if the flags are not needed", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferEverything}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : True
-- Skip return : False

foreign import ccall "g_resources_get_info" g_resources_get_info ::
    CString ->                              -- path : TBasicType TUTF8
    CUInt ->                                -- lookup_flags : TInterface (Name {namespace = "Gio", name = "ResourceLookupFlags"})
    Ptr Word64 ->                           -- size : TBasicType TUInt64
    Ptr Word32 ->                           -- flags : TBasicType TUInt32
    Ptr (Ptr GError) ->                     -- error
    IO CInt

{- |
Looks for a file at the specified /@path@/ in the set of
globally registered resources and if found returns information about it.

/@lookupFlags@/ controls the behaviour of the lookup.

/Since: 2.32/
-}
resourcesGetInfo ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@path@/: A pathname inside the resource -}
    -> [Gio.Flags.ResourceLookupFlags]
    {- ^ /@lookupFlags@/: A 'GI.Gio.Flags.ResourceLookupFlags' -}
    -> m ((Word64, Word32))
    {- ^ /(Can throw 'Data.GI.Base.GError.GError')/ -}
resourcesGetInfo path lookupFlags = liftIO $ do
    path' <- textToCString path
    let lookupFlags' = gflagsToWord lookupFlags
    size <- allocMem :: IO (Ptr Word64)
    flags <- allocMem :: IO (Ptr Word32)
    onException (do
        _ <- propagateGError $ g_resources_get_info path' lookupFlags' size flags
        size' <- peek size
        flags' <- peek flags
        freeMem path'
        freeMem size
        freeMem flags
        return (size', flags')
     ) (do
        freeMem path'
        freeMem size
        freeMem flags
     )


-- function g_resources_enumerate_children
-- Args : [Arg {argCName = "path", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A pathname inside the resource", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "lookup_flags", argType = TInterface (Name {namespace = "Gio", name = "ResourceLookupFlags"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A #GResourceLookupFlags", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TCArray True (-1) (-1) (TBasicType TUTF8))
-- throws : True
-- Skip return : False

foreign import ccall "g_resources_enumerate_children" g_resources_enumerate_children ::
    CString ->                              -- path : TBasicType TUTF8
    CUInt ->                                -- lookup_flags : TInterface (Name {namespace = "Gio", name = "ResourceLookupFlags"})
    Ptr (Ptr GError) ->                     -- error
    IO (Ptr CString)

{- |
Returns all the names of children at the specified /@path@/ in the set of
globally registered resources.
The return result is a 'Nothing' terminated list of strings which should
be released with 'GI.GLib.Functions.strfreev'.

/@lookupFlags@/ controls the behaviour of the lookup.

/Since: 2.32/
-}
resourcesEnumerateChildren ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@path@/: A pathname inside the resource -}
    -> [Gio.Flags.ResourceLookupFlags]
    {- ^ /@lookupFlags@/: A 'GI.Gio.Flags.ResourceLookupFlags' -}
    -> m [T.Text]
    {- ^ __Returns:__ an array of constant strings /(Can throw 'Data.GI.Base.GError.GError')/ -}
resourcesEnumerateChildren path lookupFlags = liftIO $ do
    path' <- textToCString path
    let lookupFlags' = gflagsToWord lookupFlags
    onException (do
        result <- propagateGError $ g_resources_enumerate_children path' lookupFlags'
        checkUnexpectedReturnNULL "resourcesEnumerateChildren" result
        result' <- unpackZeroTerminatedUTF8CArray result
        mapZeroTerminatedCArray freeMem result
        freeMem result
        freeMem path'
        return result'
     ) (do
        freeMem path'
     )


-- function g_pollable_stream_write_all
-- Args : [Arg {argCName = "stream", argType = TInterface (Name {namespace = "Gio", name = "OutputStream"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GOutputStream.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "buffer", argType = TCArray False (-1) 2 (TBasicType TUInt8), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the buffer\n  containing the data to write.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "count", argType = TBasicType TUInt64, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the number of bytes to write", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "blocking", argType = TBasicType TBoolean, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "whether to do blocking I/O", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "bytes_written", argType = TBasicType TUInt64, direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "location to store the number of bytes that was\n  written to the stream", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferEverything},Arg {argCName = "cancellable", argType = TInterface (Name {namespace = "Gio", name = "Cancellable"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "optional #GCancellable object, %NULL to ignore.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : [Arg {argCName = "count", argType = TBasicType TUInt64, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the number of bytes to write", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- returnType : Just (TBasicType TBoolean)
-- throws : True
-- Skip return : False

foreign import ccall "g_pollable_stream_write_all" g_pollable_stream_write_all ::
    Ptr Gio.OutputStream.OutputStream ->    -- stream : TInterface (Name {namespace = "Gio", name = "OutputStream"})
    Ptr Word8 ->                            -- buffer : TCArray False (-1) 2 (TBasicType TUInt8)
    Word64 ->                               -- count : TBasicType TUInt64
    CInt ->                                 -- blocking : TBasicType TBoolean
    Ptr Word64 ->                           -- bytes_written : TBasicType TUInt64
    Ptr Gio.Cancellable.Cancellable ->      -- cancellable : TInterface (Name {namespace = "Gio", name = "Cancellable"})
    Ptr (Ptr GError) ->                     -- error
    IO CInt

{- |
Tries to write /@count@/ bytes to /@stream@/, as with
'GI.Gio.Objects.OutputStream.outputStreamWriteAll', but using 'GI.Gio.Functions.pollableStreamWrite'
rather than 'GI.Gio.Objects.OutputStream.outputStreamWrite'.

On a successful write of /@count@/ bytes, 'True' is returned, and
/@bytesWritten@/ is set to /@count@/.

If there is an error during the operation (including
'GI.Gio.Enums.IOErrorEnumWouldBlock' in the non-blocking case), 'False' is
returned and /@error@/ is set to indicate the error status,
/@bytesWritten@/ is updated to contain the number of bytes written
into the stream before the error occurred.

As with 'GI.Gio.Functions.pollableStreamWrite', if /@blocking@/ is 'False', then
/@stream@/ must be a 'GI.Gio.Interfaces.PollableOutputStream.PollableOutputStream' for which
'GI.Gio.Interfaces.PollableOutputStream.pollableOutputStreamCanPoll' returns 'True' or else the
behavior is undefined. If /@blocking@/ is 'True', then /@stream@/ does not
need to be a 'GI.Gio.Interfaces.PollableOutputStream.PollableOutputStream'.

/Since: 2.34/
-}
pollableStreamWriteAll ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.OutputStream.IsOutputStream a, Gio.Cancellable.IsCancellable b) =>
    a
    {- ^ /@stream@/: a 'GI.Gio.Objects.OutputStream.OutputStream'. -}
    -> ByteString
    {- ^ /@buffer@/: the buffer
  containing the data to write. -}
    -> Bool
    {- ^ /@blocking@/: whether to do blocking I\/O -}
    -> Maybe (b)
    {- ^ /@cancellable@/: optional 'GI.Gio.Objects.Cancellable.Cancellable' object, 'Nothing' to ignore. -}
    -> m (Word64)
    {- ^ /(Can throw 'Data.GI.Base.GError.GError')/ -}
pollableStreamWriteAll stream buffer blocking cancellable = liftIO $ do
    let count = fromIntegral $ B.length buffer
    stream' <- unsafeManagedPtrCastPtr stream
    buffer' <- packByteString buffer
    let blocking' = (fromIntegral . fromEnum) blocking
    bytesWritten <- allocMem :: IO (Ptr Word64)
    maybeCancellable <- case cancellable of
        Nothing -> return nullPtr
        Just jCancellable -> do
            jCancellable' <- unsafeManagedPtrCastPtr jCancellable
            return jCancellable'
    onException (do
        _ <- propagateGError $ g_pollable_stream_write_all stream' buffer' count blocking' bytesWritten maybeCancellable
        bytesWritten' <- peek bytesWritten
        touchManagedPtr stream
        whenJust cancellable touchManagedPtr
        freeMem buffer'
        freeMem bytesWritten
        return bytesWritten'
     ) (do
        freeMem buffer'
        freeMem bytesWritten
     )


-- function g_pollable_stream_write
-- Args : [Arg {argCName = "stream", argType = TInterface (Name {namespace = "Gio", name = "OutputStream"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GOutputStream.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "buffer", argType = TCArray False (-1) 2 (TBasicType TUInt8), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the buffer\n  containing the data to write.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "count", argType = TBasicType TUInt64, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the number of bytes to write", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "blocking", argType = TBasicType TBoolean, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "whether to do blocking I/O", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "cancellable", argType = TInterface (Name {namespace = "Gio", name = "Cancellable"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "optional #GCancellable object, %NULL to ignore.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : [Arg {argCName = "count", argType = TBasicType TUInt64, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the number of bytes to write", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- returnType : Just (TBasicType TInt64)
-- throws : True
-- Skip return : False

foreign import ccall "g_pollable_stream_write" g_pollable_stream_write ::
    Ptr Gio.OutputStream.OutputStream ->    -- stream : TInterface (Name {namespace = "Gio", name = "OutputStream"})
    Ptr Word8 ->                            -- buffer : TCArray False (-1) 2 (TBasicType TUInt8)
    Word64 ->                               -- count : TBasicType TUInt64
    CInt ->                                 -- blocking : TBasicType TBoolean
    Ptr Gio.Cancellable.Cancellable ->      -- cancellable : TInterface (Name {namespace = "Gio", name = "Cancellable"})
    Ptr (Ptr GError) ->                     -- error
    IO Int64

{- |
Tries to write to /@stream@/, as with 'GI.Gio.Objects.OutputStream.outputStreamWrite' (if
/@blocking@/ is 'True') or 'GI.Gio.Interfaces.PollableOutputStream.pollableOutputStreamWriteNonblocking'
(if /@blocking@/ is 'False'). This can be used to more easily share
code between blocking and non-blocking implementations of a method.

If /@blocking@/ is 'False', then /@stream@/ must be a
'GI.Gio.Interfaces.PollableOutputStream.PollableOutputStream' for which
'GI.Gio.Interfaces.PollableOutputStream.pollableOutputStreamCanPoll' returns 'True' or else the
behavior is undefined. If /@blocking@/ is 'True', then /@stream@/ does not
need to be a 'GI.Gio.Interfaces.PollableOutputStream.PollableOutputStream'.

/Since: 2.34/
-}
pollableStreamWrite ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.OutputStream.IsOutputStream a, Gio.Cancellable.IsCancellable b) =>
    a
    {- ^ /@stream@/: a 'GI.Gio.Objects.OutputStream.OutputStream'. -}
    -> ByteString
    {- ^ /@buffer@/: the buffer
  containing the data to write. -}
    -> Bool
    {- ^ /@blocking@/: whether to do blocking I\/O -}
    -> Maybe (b)
    {- ^ /@cancellable@/: optional 'GI.Gio.Objects.Cancellable.Cancellable' object, 'Nothing' to ignore. -}
    -> m Int64
    {- ^ __Returns:__ the number of bytes written, or -1 on error. /(Can throw 'Data.GI.Base.GError.GError')/ -}
pollableStreamWrite stream buffer blocking cancellable = liftIO $ do
    let count = fromIntegral $ B.length buffer
    stream' <- unsafeManagedPtrCastPtr stream
    buffer' <- packByteString buffer
    let blocking' = (fromIntegral . fromEnum) blocking
    maybeCancellable <- case cancellable of
        Nothing -> return nullPtr
        Just jCancellable -> do
            jCancellable' <- unsafeManagedPtrCastPtr jCancellable
            return jCancellable'
    onException (do
        result <- propagateGError $ g_pollable_stream_write stream' buffer' count blocking' maybeCancellable
        touchManagedPtr stream
        whenJust cancellable touchManagedPtr
        freeMem buffer'
        return result
     ) (do
        freeMem buffer'
     )


-- function g_pollable_stream_read
-- Args : [Arg {argCName = "stream", argType = TInterface (Name {namespace = "Gio", name = "InputStream"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GInputStream", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "buffer", argType = TCArray False (-1) 2 (TBasicType TUInt8), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a buffer to\n  read data into", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "count", argType = TBasicType TUInt64, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the number of bytes to read", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "blocking", argType = TBasicType TBoolean, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "whether to do blocking I/O", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "cancellable", argType = TInterface (Name {namespace = "Gio", name = "Cancellable"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "optional #GCancellable object, %NULL to ignore.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : [Arg {argCName = "count", argType = TBasicType TUInt64, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the number of bytes to read", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- returnType : Just (TBasicType TInt64)
-- throws : True
-- Skip return : False

foreign import ccall "g_pollable_stream_read" g_pollable_stream_read ::
    Ptr Gio.InputStream.InputStream ->      -- stream : TInterface (Name {namespace = "Gio", name = "InputStream"})
    Ptr Word8 ->                            -- buffer : TCArray False (-1) 2 (TBasicType TUInt8)
    Word64 ->                               -- count : TBasicType TUInt64
    CInt ->                                 -- blocking : TBasicType TBoolean
    Ptr Gio.Cancellable.Cancellable ->      -- cancellable : TInterface (Name {namespace = "Gio", name = "Cancellable"})
    Ptr (Ptr GError) ->                     -- error
    IO Int64

{- |
Tries to read from /@stream@/, as with 'GI.Gio.Objects.InputStream.inputStreamRead' (if
/@blocking@/ is 'True') or 'GI.Gio.Interfaces.PollableInputStream.pollableInputStreamReadNonblocking'
(if /@blocking@/ is 'False'). This can be used to more easily share
code between blocking and non-blocking implementations of a method.

If /@blocking@/ is 'False', then /@stream@/ must be a
'GI.Gio.Interfaces.PollableInputStream.PollableInputStream' for which 'GI.Gio.Interfaces.PollableInputStream.pollableInputStreamCanPoll'
returns 'True', or else the behavior is undefined. If /@blocking@/ is
'True', then /@stream@/ does not need to be a 'GI.Gio.Interfaces.PollableInputStream.PollableInputStream'.

/Since: 2.34/
-}
pollableStreamRead ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.InputStream.IsInputStream a, Gio.Cancellable.IsCancellable b) =>
    a
    {- ^ /@stream@/: a 'GI.Gio.Objects.InputStream.InputStream' -}
    -> ByteString
    {- ^ /@buffer@/: a buffer to
  read data into -}
    -> Bool
    {- ^ /@blocking@/: whether to do blocking I\/O -}
    -> Maybe (b)
    {- ^ /@cancellable@/: optional 'GI.Gio.Objects.Cancellable.Cancellable' object, 'Nothing' to ignore. -}
    -> m Int64
    {- ^ __Returns:__ the number of bytes read, or -1 on error. /(Can throw 'Data.GI.Base.GError.GError')/ -}
pollableStreamRead stream buffer blocking cancellable = liftIO $ do
    let count = fromIntegral $ B.length buffer
    stream' <- unsafeManagedPtrCastPtr stream
    buffer' <- packByteString buffer
    let blocking' = (fromIntegral . fromEnum) blocking
    maybeCancellable <- case cancellable of
        Nothing -> return nullPtr
        Just jCancellable -> do
            jCancellable' <- unsafeManagedPtrCastPtr jCancellable
            return jCancellable'
    onException (do
        result <- propagateGError $ g_pollable_stream_read stream' buffer' count blocking' maybeCancellable
        touchManagedPtr stream
        whenJust cancellable touchManagedPtr
        freeMem buffer'
        return result
     ) (do
        freeMem buffer'
     )


-- function g_pollable_source_new_full
-- Args : [Arg {argCName = "pollable_stream", argType = TInterface (Name {namespace = "GObject", name = "Object"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the stream associated with the\n  new source", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "child_source", argType = TInterface (Name {namespace = "GLib", name = "Source"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "optional child source to attach", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "cancellable", argType = TInterface (Name {namespace = "Gio", name = "Cancellable"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "optional #GCancellable to attach", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "GLib", name = "Source"}))
-- throws : False
-- Skip return : False

foreign import ccall "g_pollable_source_new_full" g_pollable_source_new_full ::
    Ptr GObject.Object.Object ->            -- pollable_stream : TInterface (Name {namespace = "GObject", name = "Object"})
    Ptr GLib.Source.Source ->               -- child_source : TInterface (Name {namespace = "GLib", name = "Source"})
    Ptr Gio.Cancellable.Cancellable ->      -- cancellable : TInterface (Name {namespace = "Gio", name = "Cancellable"})
    IO (Ptr GLib.Source.Source)

{- |
Utility method for 'GI.Gio.Interfaces.PollableInputStream.PollableInputStream' and 'GI.Gio.Interfaces.PollableOutputStream.PollableOutputStream'
implementations. Creates a new 'GI.GLib.Structs.Source.Source', as with
'GI.Gio.Functions.pollableSourceNew', but also attaching /@childSource@/ (with a
dummy callback), and /@cancellable@/, if they are non-'Nothing'.

/Since: 2.34/
-}
pollableSourceNewFull ::
    (B.CallStack.HasCallStack, MonadIO m, GObject.Object.IsObject a, Gio.Cancellable.IsCancellable b) =>
    a
    {- ^ /@pollableStream@/: the stream associated with the
  new source -}
    -> Maybe (GLib.Source.Source)
    {- ^ /@childSource@/: optional child source to attach -}
    -> Maybe (b)
    {- ^ /@cancellable@/: optional 'GI.Gio.Objects.Cancellable.Cancellable' to attach -}
    -> m GLib.Source.Source
    {- ^ __Returns:__ the new 'GI.GLib.Structs.Source.Source'. -}
pollableSourceNewFull pollableStream childSource cancellable = liftIO $ do
    pollableStream' <- unsafeManagedPtrCastPtr pollableStream
    maybeChildSource <- case childSource of
        Nothing -> return nullPtr
        Just jChildSource -> do
            jChildSource' <- unsafeManagedPtrGetPtr jChildSource
            return jChildSource'
    maybeCancellable <- case cancellable of
        Nothing -> return nullPtr
        Just jCancellable -> do
            jCancellable' <- unsafeManagedPtrCastPtr jCancellable
            return jCancellable'
    result <- g_pollable_source_new_full pollableStream' maybeChildSource maybeCancellable
    checkUnexpectedReturnNULL "pollableSourceNewFull" result
    result' <- (wrapBoxed GLib.Source.Source) result
    touchManagedPtr pollableStream
    whenJust childSource touchManagedPtr
    whenJust cancellable touchManagedPtr
    return result'


-- function g_pollable_source_new
-- Args : [Arg {argCName = "pollable_stream", argType = TInterface (Name {namespace = "GObject", name = "Object"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the stream associated with the new source", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "GLib", name = "Source"}))
-- throws : False
-- Skip return : False

foreign import ccall "g_pollable_source_new" g_pollable_source_new ::
    Ptr GObject.Object.Object ->            -- pollable_stream : TInterface (Name {namespace = "GObject", name = "Object"})
    IO (Ptr GLib.Source.Source)

{- |
Utility method for 'GI.Gio.Interfaces.PollableInputStream.PollableInputStream' and 'GI.Gio.Interfaces.PollableOutputStream.PollableOutputStream'
implementations. Creates a new 'GI.GLib.Structs.Source.Source' that expects a callback of
type 'GI.Gio.Callbacks.PollableSourceFunc'. The new source does not actually do
anything on its own; use 'GI.GLib.Structs.Source.sourceAddChildSource' to add other
sources to it to cause it to trigger.

/Since: 2.28/
-}
pollableSourceNew ::
    (B.CallStack.HasCallStack, MonadIO m, GObject.Object.IsObject a) =>
    a
    {- ^ /@pollableStream@/: the stream associated with the new source -}
    -> m GLib.Source.Source
    {- ^ __Returns:__ the new 'GI.GLib.Structs.Source.Source'. -}
pollableSourceNew pollableStream = liftIO $ do
    pollableStream' <- unsafeManagedPtrCastPtr pollableStream
    result <- g_pollable_source_new pollableStream'
    checkUnexpectedReturnNULL "pollableSourceNew" result
    result' <- (wrapBoxed GLib.Source.Source) result
    touchManagedPtr pollableStream
    return result'


-- function g_null_settings_backend_new
-- Args : []
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "SettingsBackend"}))
-- throws : False
-- Skip return : False

foreign import ccall "g_null_settings_backend_new" g_null_settings_backend_new ::
    IO (Ptr Gio.SettingsBackend.SettingsBackend)

{- |
Creates a readonly 'GI.Gio.Objects.SettingsBackend.SettingsBackend'.

This backend does not allow changes to settings, so all settings
will always have their default values.

/Since: 2.28/
-}
nullSettingsBackendNew ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    m Gio.SettingsBackend.SettingsBackend
    {- ^ __Returns:__ a newly created 'GI.Gio.Objects.SettingsBackend.SettingsBackend' -}
nullSettingsBackendNew  = liftIO $ do
    result <- g_null_settings_backend_new
    checkUnexpectedReturnNULL "nullSettingsBackendNew" result
    result' <- (wrapObject Gio.SettingsBackend.SettingsBackend) result
    return result'


-- function g_networking_init
-- Args : []
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_networking_init" g_networking_init ::
    IO ()

{- |
Initializes the platform networking libraries (eg, on Windows, this
calls @/WSAStartup()/@). GLib will call this itself if it is needed, so
you only need to call it if you directly call system networking
functions (without calling any GLib networking functions first).

/Since: 2.36/
-}
networkingInit ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    m ()
networkingInit  = liftIO $ do
    g_networking_init
    return ()


-- function g_memory_settings_backend_new
-- Args : []
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "SettingsBackend"}))
-- throws : False
-- Skip return : False

foreign import ccall "g_memory_settings_backend_new" g_memory_settings_backend_new ::
    IO (Ptr Gio.SettingsBackend.SettingsBackend)

{- |
Creates a memory-backed 'GI.Gio.Objects.SettingsBackend.SettingsBackend'.

This backend allows changes to settings, but does not write them
to any backing storage, so the next time you run your application,
the memory backend will start out with the default values again.

/Since: 2.28/
-}
memorySettingsBackendNew ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    m Gio.SettingsBackend.SettingsBackend
    {- ^ __Returns:__ a newly created 'GI.Gio.Objects.SettingsBackend.SettingsBackend' -}
memorySettingsBackendNew  = liftIO $ do
    result <- g_memory_settings_backend_new
    checkUnexpectedReturnNULL "memorySettingsBackendNew" result
    result' <- (wrapObject Gio.SettingsBackend.SettingsBackend) result
    return result'


-- function g_keyfile_settings_backend_new
-- Args : [Arg {argCName = "filename", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the filename of the keyfile", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "root_path", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the path under which all settings keys appear", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "root_group", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "the group name corresponding to\n             @root_path, or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "SettingsBackend"}))
-- throws : False
-- Skip return : False

foreign import ccall "g_keyfile_settings_backend_new" g_keyfile_settings_backend_new ::
    CString ->                              -- filename : TBasicType TUTF8
    CString ->                              -- root_path : TBasicType TUTF8
    CString ->                              -- root_group : TBasicType TUTF8
    IO (Ptr Gio.SettingsBackend.SettingsBackend)

{- |
Creates a keyfile-backed 'GI.Gio.Objects.SettingsBackend.SettingsBackend'.

The filename of the keyfile to use is given by /@filename@/.

All settings read to or written from the backend must fall under the
path given in /@rootPath@/ (which must start and end with a slash and
not contain two consecutive slashes).  /@rootPath@/ may be \"\/\".

If /@rootGroup@/ is non-'Nothing' then it specifies the name of the keyfile
group used for keys that are written directly below /@rootPath@/.  For
example, if /@rootPath@/ is \"\/apps\/example\/\" and /@rootGroup@/ is
\"toplevel\", then settings the key \"\/apps\/example\/enabled\" to a value
of 'True' will cause the following to appear in the keyfile:

>
>  [toplevel]
>  enabled=true


If /@rootGroup@/ is 'Nothing' then it is not permitted to store keys
directly below the /@rootPath@/.

For keys not stored directly below /@rootPath@/ (ie: in a sub-path),
the name of the subpath (with the final slash stripped) is used as
the name of the keyfile group.  To continue the example, if
\"\/apps\/example\/profiles\/default\/font-size\" were set to
12 then the following would appear in the keyfile:

>
>  [profiles/default]
>  font-size=12


The backend will refuse writes (and return writability as being
'False') for keys outside of /@rootPath@/ and, in the event that
/@rootGroup@/ is 'Nothing', also for keys directly under /@rootPath@/.
Writes will also be refused if the backend detects that it has the
inability to rewrite the keyfile (ie: the containing directory is not
writable).

There is no checking done for your key namespace clashing with the
syntax of the key file format.  For example, if you have \'[\' or \']\'
characters in your path names or \'=\' in your key names you may be in
trouble.
-}
keyfileSettingsBackendNew ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@filename@/: the filename of the keyfile -}
    -> T.Text
    {- ^ /@rootPath@/: the path under which all settings keys appear -}
    -> Maybe (T.Text)
    {- ^ /@rootGroup@/: the group name corresponding to
             /@rootPath@/, or 'Nothing' -}
    -> m Gio.SettingsBackend.SettingsBackend
    {- ^ __Returns:__ a keyfile-backed 'GI.Gio.Objects.SettingsBackend.SettingsBackend' -}
keyfileSettingsBackendNew filename rootPath rootGroup = liftIO $ do
    filename' <- textToCString filename
    rootPath' <- textToCString rootPath
    maybeRootGroup <- case rootGroup of
        Nothing -> return nullPtr
        Just jRootGroup -> do
            jRootGroup' <- textToCString jRootGroup
            return jRootGroup'
    result <- g_keyfile_settings_backend_new filename' rootPath' maybeRootGroup
    checkUnexpectedReturnNULL "keyfileSettingsBackendNew" result
    result' <- (wrapObject Gio.SettingsBackend.SettingsBackend) result
    freeMem filename'
    freeMem rootPath'
    freeMem maybeRootGroup
    return result'


-- function g_io_scheduler_push_job
-- Args : [Arg {argCName = "job_func", argType = TInterface (Name {namespace = "Gio", name = "IOSchedulerJobFunc"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GIOSchedulerJobFunc.", sinceVersion = Nothing}, argScope = ScopeTypeNotified, argClosure = 1, argDestroy = 2, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "user_data", argType = TBasicType TPtr, direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "data to pass to @job_func", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "notify", argType = TInterface (Name {namespace = "GLib", name = "DestroyNotify"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "a #GDestroyNotify for @user_data, or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeAsync, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "io_priority", argType = TBasicType TInt, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the [I/O priority][io-priority]\nof the request.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "cancellable", argType = TInterface (Name {namespace = "Gio", name = "Cancellable"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "optional #GCancellable object, %NULL to ignore.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_io_scheduler_push_job" g_io_scheduler_push_job ::
    FunPtr Gio.Callbacks.C_IOSchedulerJobFunc -> -- job_func : TInterface (Name {namespace = "Gio", name = "IOSchedulerJobFunc"})
    Ptr () ->                               -- user_data : TBasicType TPtr
    FunPtr GLib.Callbacks.C_DestroyNotify -> -- notify : TInterface (Name {namespace = "GLib", name = "DestroyNotify"})
    Int32 ->                                -- io_priority : TBasicType TInt
    Ptr Gio.Cancellable.Cancellable ->      -- cancellable : TInterface (Name {namespace = "Gio", name = "Cancellable"})
    IO ()

{-# DEPRECATED ioSchedulerPushJob ["use 'GI.GLib.Structs.ThreadPool.ThreadPool' or @/g_task_run_in_thread()/@"] #-}
{- |
Schedules the I\/O job to run in another thread.

/@notify@/ will be called on /@userData@/ after /@jobFunc@/ has returned,
regardless whether the job was cancelled or has run to completion.

If /@cancellable@/ is not 'Nothing', it can be used to cancel the I\/O job
by calling 'GI.Gio.Objects.Cancellable.cancellableCancel' or by calling
'GI.Gio.Functions.ioSchedulerCancelAllJobs'.
-}
ioSchedulerPushJob ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.Cancellable.IsCancellable a) =>
    Gio.Callbacks.IOSchedulerJobFunc
    {- ^ /@jobFunc@/: a 'GI.Gio.Callbacks.IOSchedulerJobFunc'. -}
    -> Int32
    {- ^ /@ioPriority@/: the [I\/O priority][io-priority]
of the request. -}
    -> Maybe (a)
    {- ^ /@cancellable@/: optional 'GI.Gio.Objects.Cancellable.Cancellable' object, 'Nothing' to ignore. -}
    -> m ()
ioSchedulerPushJob jobFunc ioPriority cancellable = liftIO $ do
    jobFunc' <- Gio.Callbacks.mk_IOSchedulerJobFunc (Gio.Callbacks.wrap_IOSchedulerJobFunc Nothing (Gio.Callbacks.drop_closures_IOSchedulerJobFunc jobFunc))
    maybeCancellable <- case cancellable of
        Nothing -> return nullPtr
        Just jCancellable -> do
            jCancellable' <- unsafeManagedPtrCastPtr jCancellable
            return jCancellable'
    let userData = castFunPtrToPtr jobFunc'
    let notify = safeFreeFunPtrPtr
    g_io_scheduler_push_job jobFunc' userData notify ioPriority maybeCancellable
    whenJust cancellable touchManagedPtr
    return ()


-- function g_io_scheduler_cancel_all_jobs
-- Args : []
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_io_scheduler_cancel_all_jobs" g_io_scheduler_cancel_all_jobs ::
    IO ()

{-# DEPRECATED ioSchedulerCancelAllJobs ["You should never call this function, since you don\\'t","know how other libraries in your program might be making use of","gioscheduler."] #-}
{- |
Cancels all cancellable I\/O jobs.

A job is cancellable if a 'GI.Gio.Objects.Cancellable.Cancellable' was passed into
'GI.Gio.Functions.ioSchedulerPushJob'.
-}
ioSchedulerCancelAllJobs ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    m ()
ioSchedulerCancelAllJobs  = liftIO $ do
    g_io_scheduler_cancel_all_jobs
    return ()


-- function g_io_modules_scan_all_in_directory_with_scope
-- Args : [Arg {argCName = "dirname", argType = TBasicType TFileName, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "pathname for a directory containing modules\n    to scan.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "scope", argType = TInterface (Name {namespace = "Gio", name = "IOModuleScope"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a scope to use when scanning the modules", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_io_modules_scan_all_in_directory_with_scope" g_io_modules_scan_all_in_directory_with_scope ::
    CString ->                              -- dirname : TBasicType TFileName
    Ptr Gio.IOModuleScope.IOModuleScope ->  -- scope : TInterface (Name {namespace = "Gio", name = "IOModuleScope"})
    IO ()

{- |
Scans all the modules in the specified directory, ensuring that
any extension point implemented by a module is registered.

This may not actually load and initialize all the types in each
module, some modules may be lazily loaded and initialized when
an extension point it implementes is used with e.g.
'GI.Gio.Structs.IOExtensionPoint.iOExtensionPointGetExtensions' or
'GI.Gio.Structs.IOExtensionPoint.iOExtensionPointGetExtensionByName'.

If you need to guarantee that all types are loaded in all the modules,
use @/g_io_modules_load_all_in_directory()/@.

/Since: 2.30/
-}
ioModulesScanAllInDirectoryWithScope ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    [Char]
    {- ^ /@dirname@/: pathname for a directory containing modules
    to scan. -}
    -> Gio.IOModuleScope.IOModuleScope
    {- ^ /@scope@/: a scope to use when scanning the modules -}
    -> m ()
ioModulesScanAllInDirectoryWithScope dirname scope = liftIO $ do
    dirname' <- stringToCString dirname
    scope' <- unsafeManagedPtrGetPtr scope
    g_io_modules_scan_all_in_directory_with_scope dirname' scope'
    touchManagedPtr scope
    freeMem dirname'
    return ()


-- function g_io_modules_scan_all_in_directory
-- Args : [Arg {argCName = "dirname", argType = TBasicType TFileName, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "pathname for a directory containing modules\n    to scan.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_io_modules_scan_all_in_directory" g_io_modules_scan_all_in_directory ::
    CString ->                              -- dirname : TBasicType TFileName
    IO ()

{- |
Scans all the modules in the specified directory, ensuring that
any extension point implemented by a module is registered.

This may not actually load and initialize all the types in each
module, some modules may be lazily loaded and initialized when
an extension point it implementes is used with e.g.
'GI.Gio.Structs.IOExtensionPoint.iOExtensionPointGetExtensions' or
'GI.Gio.Structs.IOExtensionPoint.iOExtensionPointGetExtensionByName'.

If you need to guarantee that all types are loaded in all the modules,
use @/g_io_modules_load_all_in_directory()/@.

/Since: 2.24/
-}
ioModulesScanAllInDirectory ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    [Char]
    {- ^ /@dirname@/: pathname for a directory containing modules
    to scan. -}
    -> m ()
ioModulesScanAllInDirectory dirname = liftIO $ do
    dirname' <- stringToCString dirname
    g_io_modules_scan_all_in_directory dirname'
    freeMem dirname'
    return ()


-- function g_io_error_quark
-- Args : []
-- Lengths : []
-- returnType : Just (TBasicType TUInt32)
-- throws : False
-- Skip return : False

foreign import ccall "g_io_error_quark" g_io_error_quark ::
    IO Word32

{- |
Gets the GIO Error Quark.
-}
ioErrorQuark ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    m Word32
    {- ^ __Returns:__ a @/GQuark/@. -}
ioErrorQuark  = liftIO $ do
    result <- g_io_error_quark
    return result


-- function g_io_error_from_errno
-- Args : [Arg {argCName = "err_no", argType = TBasicType TInt, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "Error number as defined in errno.h.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "IOErrorEnum"}))
-- throws : False
-- Skip return : False

foreign import ccall "g_io_error_from_errno" g_io_error_from_errno ::
    Int32 ->                                -- err_no : TBasicType TInt
    IO CUInt

{- |
Converts errno.h error codes into GIO error codes. The fallback
value 'GI.Gio.Enums.IOErrorEnumFailed' is returned for error codes not currently
handled (but note that future GLib releases may return a more
specific value instead).

As @/errno/@ is global and may be modified by intermediate function
calls, you should save its value as soon as the call which sets it
-}
ioErrorFromErrno ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Int32
    {- ^ /@errNo@/: Error number as defined in errno.h. -}
    -> m Gio.Enums.IOErrorEnum
    {- ^ __Returns:__ 'GI.Gio.Enums.IOErrorEnum' value for the given errno.h error number. -}
ioErrorFromErrno errNo = liftIO $ do
    result <- g_io_error_from_errno errNo
    let result' = (toEnum . fromIntegral) result
    return result'


-- function g_dbus_is_unique_name
-- Args : [Arg {argCName = "string", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "The string to check.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_dbus_is_unique_name" g_dbus_is_unique_name ::
    CString ->                              -- string : TBasicType TUTF8
    IO CInt

{- |
Checks if /@string@/ is a valid D-Bus unique bus name.

/Since: 2.26/
-}
dbusIsUniqueName ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@string@/: The string to check. -}
    -> m Bool
    {- ^ __Returns:__ 'True' if valid, 'False' otherwise. -}
dbusIsUniqueName string = liftIO $ do
    string' <- textToCString string
    result <- g_dbus_is_unique_name string'
    let result' = (/= 0) result
    freeMem string'
    return result'


-- function g_dbus_is_supported_address
-- Args : [Arg {argCName = "string", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A string.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : True
-- Skip return : False

foreign import ccall "g_dbus_is_supported_address" g_dbus_is_supported_address ::
    CString ->                              -- string : TBasicType TUTF8
    Ptr (Ptr GError) ->                     -- error
    IO CInt

{- |
Like 'GI.Gio.Functions.dbusIsAddress' but also checks if the library supports the
transports in /@string@/ and that key\/value pairs for each transport
are valid. See the specification of the
<https://dbus.freedesktop.org/doc/dbus-specification.html#addresses D-Bus address format>.

/Since: 2.26/
-}
dbusIsSupportedAddress ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@string@/: A string. -}
    -> m ()
    {- ^ /(Can throw 'Data.GI.Base.GError.GError')/ -}
dbusIsSupportedAddress string = liftIO $ do
    string' <- textToCString string
    onException (do
        _ <- propagateGError $ g_dbus_is_supported_address string'
        freeMem string'
        return ()
     ) (do
        freeMem string'
     )


-- function g_dbus_is_name
-- Args : [Arg {argCName = "string", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "The string to check.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_dbus_is_name" g_dbus_is_name ::
    CString ->                              -- string : TBasicType TUTF8
    IO CInt

{- |
Checks if /@string@/ is a valid D-Bus bus name (either unique or well-known).

/Since: 2.26/
-}
dbusIsName ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@string@/: The string to check. -}
    -> m Bool
    {- ^ __Returns:__ 'True' if valid, 'False' otherwise. -}
dbusIsName string = liftIO $ do
    string' <- textToCString string
    result <- g_dbus_is_name string'
    let result' = (/= 0) result
    freeMem string'
    return result'


-- function g_dbus_is_member_name
-- Args : [Arg {argCName = "string", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "The string to check.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_dbus_is_member_name" g_dbus_is_member_name ::
    CString ->                              -- string : TBasicType TUTF8
    IO CInt

{- |
Checks if /@string@/ is a valid D-Bus member (e.g. signal or method) name.

/Since: 2.26/
-}
dbusIsMemberName ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@string@/: The string to check. -}
    -> m Bool
    {- ^ __Returns:__ 'True' if valid, 'False' otherwise. -}
dbusIsMemberName string = liftIO $ do
    string' <- textToCString string
    result <- g_dbus_is_member_name string'
    let result' = (/= 0) result
    freeMem string'
    return result'


-- function g_dbus_is_interface_name
-- Args : [Arg {argCName = "string", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "The string to check.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_dbus_is_interface_name" g_dbus_is_interface_name ::
    CString ->                              -- string : TBasicType TUTF8
    IO CInt

{- |
Checks if /@string@/ is a valid D-Bus interface name.

/Since: 2.26/
-}
dbusIsInterfaceName ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@string@/: The string to check. -}
    -> m Bool
    {- ^ __Returns:__ 'True' if valid, 'False' otherwise. -}
dbusIsInterfaceName string = liftIO $ do
    string' <- textToCString string
    result <- g_dbus_is_interface_name string'
    let result' = (/= 0) result
    freeMem string'
    return result'


-- function g_dbus_is_guid
-- Args : [Arg {argCName = "string", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "The string to check.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_dbus_is_guid" g_dbus_is_guid ::
    CString ->                              -- string : TBasicType TUTF8
    IO CInt

{- |
Checks if /@string@/ is a D-Bus GUID.

See the D-Bus specification regarding what strings are valid D-Bus
GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).

/Since: 2.26/
-}
dbusIsGuid ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@string@/: The string to check. -}
    -> m Bool
    {- ^ __Returns:__ 'True' if /@string@/ is a guid, 'False' otherwise. -}
dbusIsGuid string = liftIO $ do
    string' <- textToCString string
    result <- g_dbus_is_guid string'
    let result' = (/= 0) result
    freeMem string'
    return result'


-- function g_dbus_is_address
-- Args : [Arg {argCName = "string", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A string.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_dbus_is_address" g_dbus_is_address ::
    CString ->                              -- string : TBasicType TUTF8
    IO CInt

{- |
Checks if /@string@/ is a
<https://dbus.freedesktop.org/doc/dbus-specification.html#addresses D-Bus address>.

This doesn\'t check if /@string@/ is actually supported by 'GI.Gio.Objects.DBusServer.DBusServer'
or 'GI.Gio.Objects.DBusConnection.DBusConnection' - use 'GI.Gio.Functions.dbusIsSupportedAddress' to do more
checks.

/Since: 2.26/
-}
dbusIsAddress ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@string@/: A string. -}
    -> m Bool
    {- ^ __Returns:__ 'True' if /@string@/ is a valid D-Bus address, 'False' otherwise. -}
dbusIsAddress string = liftIO $ do
    string' <- textToCString string
    result <- g_dbus_is_address string'
    let result' = (/= 0) result
    freeMem string'
    return result'


-- function g_dbus_gvariant_to_gvalue
-- Args : [Arg {argCName = "value", argType = TVariant, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A #GVariant.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "out_gvalue", argType = TInterface (Name {namespace = "GObject", name = "Value"}), direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "Return location pointing to a zero-filled (uninitialized) #GValue.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = True, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_dbus_gvariant_to_gvalue" g_dbus_gvariant_to_gvalue ::
    Ptr GVariant ->                         -- value : TVariant
    Ptr GValue ->                           -- out_gvalue : TInterface (Name {namespace = "GObject", name = "Value"})
    IO ()

{- |
Converts a 'GVariant' to a 'GI.GObject.Structs.Value.Value'. If /@value@/ is floating, it is consumed.

The rules specified in the 'GI.Gio.Functions.dbusGvalueToGvariant' function are
used - this function is essentially its reverse form. So, a 'GVariant'
containing any basic or string array type will be converted to a 'GI.GObject.Structs.Value.Value'
containing a basic value or string array. Any other 'GVariant' (handle,
variant, tuple, dict entry) will be converted to a 'GI.GObject.Structs.Value.Value' containing that
'GVariant'.

The conversion never fails - a valid 'GI.GObject.Structs.Value.Value' is always returned in
/@outGvalue@/.

/Since: 2.30/
-}
dbusGvariantToGvalue ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    GVariant
    {- ^ /@value@/: A 'GVariant'. -}
    -> m (GValue)
dbusGvariantToGvalue value = liftIO $ do
    value' <- unsafeManagedPtrGetPtr value
    outGvalue <- callocBoxedBytes 24 :: IO (Ptr GValue)
    g_dbus_gvariant_to_gvalue value' outGvalue
    outGvalue' <- (wrapBoxed GValue) outGvalue
    touchManagedPtr value
    return outGvalue'


-- function g_dbus_gvalue_to_gvariant
-- Args : [Arg {argCName = "gvalue", argType = TInterface (Name {namespace = "GObject", name = "Value"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A #GValue to convert to a #GVariant", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "type", argType = TInterface (Name {namespace = "GLib", name = "VariantType"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A #GVariantType", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just TVariant
-- throws : False
-- Skip return : False

foreign import ccall "g_dbus_gvalue_to_gvariant" g_dbus_gvalue_to_gvariant ::
    Ptr GValue ->                           -- gvalue : TInterface (Name {namespace = "GObject", name = "Value"})
    Ptr GLib.VariantType.VariantType ->     -- type : TInterface (Name {namespace = "GLib", name = "VariantType"})
    IO (Ptr GVariant)

{- |
Converts a 'GI.GObject.Structs.Value.Value' to a 'GVariant' of the type indicated by the /@type@/
parameter.

The conversion is using the following rules:

* @/G_TYPE_STRING/@: \'s\', \'o\', \'g\' or \'ay\'
* @/G_TYPE_STRV/@: \'as\', \'ao\' or \'aay\'
* @/G_TYPE_BOOLEAN/@: \'b\'
* @/G_TYPE_UCHAR/@: \'y\'
* @/G_TYPE_INT/@: \'i\', \'n\'
* @/G_TYPE_UINT/@: \'u\', \'q\'
* @/G_TYPE_INT64/@ \'x\'
* @/G_TYPE_UINT64/@: \'t\'
* @/G_TYPE_DOUBLE/@: \'d\'
* @/G_TYPE_VARIANT/@: Any 'GI.GLib.Structs.VariantType.VariantType'


This can fail if e.g. /@gvalue@/ is of type @/G_TYPE_STRING/@ and /@type@/
is [\'i\'][G-VARIANT-TYPE-INT32:CAPS]. It will also fail for any 'GType'
(including e.g. @/G_TYPE_OBJECT/@ and @/G_TYPE_BOXED/@ derived-types) not
in the table above.

Note that if /@gvalue@/ is of type @/G_TYPE_VARIANT/@ and its value is
'Nothing', the empty 'GVariant' instance (never 'Nothing') for /@type@/ is
returned (e.g. 0 for scalar types, the empty string for string types,
\'\/\' for object path types, the empty array for any array type and so on).

See the 'GI.Gio.Functions.dbusGvariantToGvalue' function for how to convert a
'GVariant' to a 'GI.GObject.Structs.Value.Value'.

/Since: 2.30/
-}
dbusGvalueToGvariant ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    GValue
    {- ^ /@gvalue@/: A 'GI.GObject.Structs.Value.Value' to convert to a 'GVariant' -}
    -> GLib.VariantType.VariantType
    {- ^ /@type@/: A 'GI.GLib.Structs.VariantType.VariantType' -}
    -> m GVariant
    {- ^ __Returns:__ A 'GVariant' (never floating) of 'GI.GLib.Structs.VariantType.VariantType' /@type@/ holding
    the data from /@gvalue@/ or 'Nothing' in case of failure. Free with
    'GI.GLib.Structs.Variant.variantUnref'. -}
dbusGvalueToGvariant gvalue type_ = liftIO $ do
    gvalue' <- unsafeManagedPtrGetPtr gvalue
    type_' <- unsafeManagedPtrGetPtr type_
    result <- g_dbus_gvalue_to_gvariant gvalue' type_'
    checkUnexpectedReturnNULL "dbusGvalueToGvariant" result
    result' <- B.GVariant.wrapGVariantPtr result
    touchManagedPtr gvalue
    touchManagedPtr type_
    return result'


-- function g_dbus_generate_guid
-- Args : []
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False

foreign import ccall "g_dbus_generate_guid" g_dbus_generate_guid ::
    IO CString

{- |
Generate a D-Bus GUID that can be used with
e.g. 'GI.Gio.Objects.DBusConnection.dBusConnectionNew'.

See the D-Bus specification regarding what strings are valid D-Bus
GUID (for example, D-Bus GUIDs are not RFC-4122 compliant).

/Since: 2.26/
-}
dbusGenerateGuid ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    m T.Text
    {- ^ __Returns:__ A valid D-Bus GUID. Free with 'GI.GLib.Functions.free'. -}
dbusGenerateGuid  = liftIO $ do
    result <- g_dbus_generate_guid
    checkUnexpectedReturnNULL "dbusGenerateGuid" result
    result' <- cstringToText result
    freeMem result
    return result'


-- function g_dbus_address_get_stream_sync
-- Args : [Arg {argCName = "address", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A valid D-Bus address.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "out_guid", argType = TBasicType TUTF8, direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "%NULL or return location to store the GUID extracted from @address, if any.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferEverything},Arg {argCName = "cancellable", argType = TInterface (Name {namespace = "Gio", name = "Cancellable"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "A #GCancellable or %NULL.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "IOStream"}))
-- throws : True
-- Skip return : False

foreign import ccall "g_dbus_address_get_stream_sync" g_dbus_address_get_stream_sync ::
    CString ->                              -- address : TBasicType TUTF8
    Ptr CString ->                          -- out_guid : TBasicType TUTF8
    Ptr Gio.Cancellable.Cancellable ->      -- cancellable : TInterface (Name {namespace = "Gio", name = "Cancellable"})
    Ptr (Ptr GError) ->                     -- error
    IO (Ptr Gio.IOStream.IOStream)

{- |
Synchronously connects to an endpoint specified by /@address@/ and
sets up the connection so it is in a state to run the client-side
of the D-Bus authentication conversation. /@address@/ must be in the
<https://dbus.freedesktop.org/doc/dbus-specification.html#addresses D-Bus address format>.

This is a synchronous failable function. See
'GI.Gio.Functions.dbusAddressGetStream' for the asynchronous version.

/Since: 2.26/
-}
dbusAddressGetStreamSync ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.Cancellable.IsCancellable a) =>
    T.Text
    {- ^ /@address@/: A valid D-Bus address. -}
    -> Maybe (a)
    {- ^ /@cancellable@/: A 'GI.Gio.Objects.Cancellable.Cancellable' or 'Nothing'. -}
    -> m ((Gio.IOStream.IOStream, T.Text))
    {- ^ __Returns:__ A 'GI.Gio.Objects.IOStream.IOStream' or 'Nothing' if /@error@/ is set. /(Can throw 'Data.GI.Base.GError.GError')/ -}
dbusAddressGetStreamSync address cancellable = liftIO $ do
    address' <- textToCString address
    outGuid <- allocMem :: IO (Ptr CString)
    maybeCancellable <- case cancellable of
        Nothing -> return nullPtr
        Just jCancellable -> do
            jCancellable' <- unsafeManagedPtrCastPtr jCancellable
            return jCancellable'
    onException (do
        result <- propagateGError $ g_dbus_address_get_stream_sync address' outGuid maybeCancellable
        checkUnexpectedReturnNULL "dbusAddressGetStreamSync" result
        result' <- (wrapObject Gio.IOStream.IOStream) result
        outGuid' <- peek outGuid
        outGuid'' <- cstringToText outGuid'
        freeMem outGuid'
        whenJust cancellable touchManagedPtr
        freeMem address'
        freeMem outGuid
        return (result', outGuid'')
     ) (do
        freeMem address'
        freeMem outGuid
     )


-- function g_dbus_address_get_stream_finish
-- Args : [Arg {argCName = "res", argType = TInterface (Name {namespace = "Gio", name = "AsyncResult"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A #GAsyncResult obtained from the GAsyncReadyCallback passed to g_dbus_address_get_stream().", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "out_guid", argType = TBasicType TUTF8, direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "%NULL or return location to store the GUID extracted from @address, if any.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferEverything}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "IOStream"}))
-- throws : True
-- Skip return : False

foreign import ccall "g_dbus_address_get_stream_finish" g_dbus_address_get_stream_finish ::
    Ptr Gio.AsyncResult.AsyncResult ->      -- res : TInterface (Name {namespace = "Gio", name = "AsyncResult"})
    Ptr CString ->                          -- out_guid : TBasicType TUTF8
    Ptr (Ptr GError) ->                     -- error
    IO (Ptr Gio.IOStream.IOStream)

{- |
Finishes an operation started with 'GI.Gio.Functions.dbusAddressGetStream'.

/Since: 2.26/
-}
dbusAddressGetStreamFinish ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.AsyncResult.IsAsyncResult a) =>
    a
    {- ^ /@res@/: A 'GI.Gio.Interfaces.AsyncResult.AsyncResult' obtained from the GAsyncReadyCallback passed to 'GI.Gio.Functions.dbusAddressGetStream'. -}
    -> m ((Gio.IOStream.IOStream, T.Text))
    {- ^ __Returns:__ A 'GI.Gio.Objects.IOStream.IOStream' or 'Nothing' if /@error@/ is set. /(Can throw 'Data.GI.Base.GError.GError')/ -}
dbusAddressGetStreamFinish res = liftIO $ do
    res' <- unsafeManagedPtrCastPtr res
    outGuid <- allocMem :: IO (Ptr CString)
    onException (do
        result <- propagateGError $ g_dbus_address_get_stream_finish res' outGuid
        checkUnexpectedReturnNULL "dbusAddressGetStreamFinish" result
        result' <- (wrapObject Gio.IOStream.IOStream) result
        outGuid' <- peek outGuid
        outGuid'' <- cstringToText outGuid'
        freeMem outGuid'
        touchManagedPtr res
        freeMem outGuid
        return (result', outGuid'')
     ) (do
        freeMem outGuid
     )


-- function g_dbus_address_get_stream
-- Args : [Arg {argCName = "address", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A valid D-Bus address.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "cancellable", argType = TInterface (Name {namespace = "Gio", name = "Cancellable"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "A #GCancellable or %NULL.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "callback", argType = TInterface (Name {namespace = "Gio", name = "AsyncReadyCallback"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "A #GAsyncReadyCallback to call when the request is satisfied.", sinceVersion = Nothing}, argScope = ScopeTypeAsync, argClosure = 3, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "user_data", argType = TBasicType TPtr, direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "Data to pass to @callback.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_dbus_address_get_stream" g_dbus_address_get_stream ::
    CString ->                              -- address : TBasicType TUTF8
    Ptr Gio.Cancellable.Cancellable ->      -- cancellable : TInterface (Name {namespace = "Gio", name = "Cancellable"})
    FunPtr Gio.Callbacks.C_AsyncReadyCallback -> -- callback : TInterface (Name {namespace = "Gio", name = "AsyncReadyCallback"})
    Ptr () ->                               -- user_data : TBasicType TPtr
    IO ()

{- |
Asynchronously connects to an endpoint specified by /@address@/ and
sets up the connection so it is in a state to run the client-side
of the D-Bus authentication conversation. /@address@/ must be in the
<https://dbus.freedesktop.org/doc/dbus-specification.html#addresses D-Bus address format>.

When the operation is finished, /@callback@/ will be invoked. You can
then call 'GI.Gio.Functions.dbusAddressGetStreamFinish' to get the result of
the operation.

This is an asynchronous failable function. See
'GI.Gio.Functions.dbusAddressGetStreamSync' for the synchronous version.

/Since: 2.26/
-}
dbusAddressGetStream ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.Cancellable.IsCancellable a) =>
    T.Text
    {- ^ /@address@/: A valid D-Bus address. -}
    -> Maybe (a)
    {- ^ /@cancellable@/: A 'GI.Gio.Objects.Cancellable.Cancellable' or 'Nothing'. -}
    -> Maybe (Gio.Callbacks.AsyncReadyCallback)
    {- ^ /@callback@/: A 'GI.Gio.Callbacks.AsyncReadyCallback' to call when the request is satisfied. -}
    -> m ()
dbusAddressGetStream address cancellable callback = liftIO $ do
    address' <- textToCString address
    maybeCancellable <- case cancellable of
        Nothing -> return nullPtr
        Just jCancellable -> do
            jCancellable' <- unsafeManagedPtrCastPtr jCancellable
            return jCancellable'
    maybeCallback <- case callback of
        Nothing -> return (castPtrToFunPtr nullPtr)
        Just jCallback -> do
            ptrcallback <- callocMem :: IO (Ptr (FunPtr Gio.Callbacks.C_AsyncReadyCallback))
            jCallback' <- Gio.Callbacks.mk_AsyncReadyCallback (Gio.Callbacks.wrap_AsyncReadyCallback (Just ptrcallback) (Gio.Callbacks.drop_closures_AsyncReadyCallback jCallback))
            poke ptrcallback jCallback'
            return jCallback'
    let userData = nullPtr
    g_dbus_address_get_stream address' maybeCancellable maybeCallback userData
    whenJust cancellable touchManagedPtr
    freeMem address'
    return ()


-- function g_dbus_address_get_for_bus_sync
-- Args : [Arg {argCName = "bus_type", argType = TInterface (Name {namespace = "Gio", name = "BusType"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GBusType", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "cancellable", argType = TInterface (Name {namespace = "Gio", name = "Cancellable"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "a #GCancellable or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : True
-- Skip return : False

foreign import ccall "g_dbus_address_get_for_bus_sync" g_dbus_address_get_for_bus_sync ::
    CUInt ->                                -- bus_type : TInterface (Name {namespace = "Gio", name = "BusType"})
    Ptr Gio.Cancellable.Cancellable ->      -- cancellable : TInterface (Name {namespace = "Gio", name = "Cancellable"})
    Ptr (Ptr GError) ->                     -- error
    IO CString

{- |
Synchronously looks up the D-Bus address for the well-known message
bus instance specified by /@busType@/. This may involve using various
platform specific mechanisms.

The returned address will be in the
<https://dbus.freedesktop.org/doc/dbus-specification.html#addresses D-Bus address format>.

/Since: 2.26/
-}
dbusAddressGetForBusSync ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.Cancellable.IsCancellable a) =>
    Gio.Enums.BusType
    {- ^ /@busType@/: a 'GI.Gio.Enums.BusType' -}
    -> Maybe (a)
    {- ^ /@cancellable@/: a 'GI.Gio.Objects.Cancellable.Cancellable' or 'Nothing' -}
    -> m T.Text
    {- ^ __Returns:__ a valid D-Bus address string for /@busType@/ or 'Nothing' if
    /@error@/ is set /(Can throw 'Data.GI.Base.GError.GError')/ -}
dbusAddressGetForBusSync busType cancellable = liftIO $ do
    let busType' = (fromIntegral . fromEnum) busType
    maybeCancellable <- case cancellable of
        Nothing -> return nullPtr
        Just jCancellable -> do
            jCancellable' <- unsafeManagedPtrCastPtr jCancellable
            return jCancellable'
    onException (do
        result <- propagateGError $ g_dbus_address_get_for_bus_sync busType' maybeCancellable
        checkUnexpectedReturnNULL "dbusAddressGetForBusSync" result
        result' <- cstringToText result
        freeMem result
        whenJust cancellable touchManagedPtr
        return result'
     ) (do
        return ()
     )


-- function g_dbus_address_escape_value
-- Args : [Arg {argCName = "string", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "an unescaped string to be included in a D-Bus address\n    as the value in a key-value pair", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False

foreign import ccall "g_dbus_address_escape_value" g_dbus_address_escape_value ::
    CString ->                              -- string : TBasicType TUTF8
    IO CString

{- |
Escape /@string@/ so it can appear in a D-Bus address as the value
part of a key-value pair.

For instance, if /@string@/ is @\/run\/bus-for-:0@,
this function would return @\/run\/bus-for-%3A0@,
which could be used in a D-Bus address like
@unix:nonce-tcp:host=127.0.0.1,port=42,noncefile=\/run\/bus-for-%3A0@.

/Since: 2.36/
-}
dbusAddressEscapeValue ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@string@/: an unescaped string to be included in a D-Bus address
    as the value in a key-value pair -}
    -> m T.Text
    {- ^ __Returns:__ a copy of /@string@/ with all
    non-optionally-escaped bytes escaped -}
dbusAddressEscapeValue string = liftIO $ do
    string' <- textToCString string
    result <- g_dbus_address_escape_value string'
    checkUnexpectedReturnNULL "dbusAddressEscapeValue" result
    result' <- cstringToText result
    freeMem result
    freeMem string'
    return result'


-- function g_content_types_get_registered
-- Args : []
-- Lengths : []
-- returnType : Just (TGList (TBasicType TUTF8))
-- throws : False
-- Skip return : False

foreign import ccall "g_content_types_get_registered" g_content_types_get_registered ::
    IO (Ptr (GList CString))

{- |
Gets a list of strings containing all the registered content types
known to the system. The list and its data should be freed using
g_list_free_full (list, g_free).
-}
contentTypesGetRegistered ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    m [T.Text]
    {- ^ __Returns:__ list of the registered
    content types -}
contentTypesGetRegistered  = liftIO $ do
    result <- g_content_types_get_registered
    result' <- unpackGList result
    result'' <- mapM cstringToText result'
    mapGList freeMem result
    g_list_free result
    return result''


-- function g_content_type_is_unknown
-- Args : [Arg {argCName = "type", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a content type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_content_type_is_unknown" g_content_type_is_unknown ::
    CString ->                              -- type : TBasicType TUTF8
    IO CInt

{- |
Checks if the content type is the generic \"unknown\" type.
On UNIX this is the \"application\/octet-stream\" mimetype,
while on win32 it is \"*\" and on OSX it is a dynamic type
or octet-stream.
-}
contentTypeIsUnknown ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@type@/: a content type string -}
    -> m Bool
    {- ^ __Returns:__ 'True' if the type is the unknown type. -}
contentTypeIsUnknown type_ = liftIO $ do
    type_' <- textToCString type_
    result <- g_content_type_is_unknown type_'
    let result' = (/= 0) result
    freeMem type_'
    return result'


-- function g_content_type_is_mime_type
-- Args : [Arg {argCName = "type", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a content type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "mime_type", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a mime type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_content_type_is_mime_type" g_content_type_is_mime_type ::
    CString ->                              -- type : TBasicType TUTF8
    CString ->                              -- mime_type : TBasicType TUTF8
    IO CInt

{- |
Determines if /@type@/ is a subset of /@mimeType@/.
Convenience wrapper around 'GI.Gio.Functions.contentTypeIsA'.

/Since: 2.52/
-}
contentTypeIsMimeType ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@type@/: a content type string -}
    -> T.Text
    {- ^ /@mimeType@/: a mime type string -}
    -> m Bool
    {- ^ __Returns:__ 'True' if /@type@/ is a kind of /@mimeType@/,
    'False' otherwise. -}
contentTypeIsMimeType type_ mimeType = liftIO $ do
    type_' <- textToCString type_
    mimeType' <- textToCString mimeType
    result <- g_content_type_is_mime_type type_' mimeType'
    let result' = (/= 0) result
    freeMem type_'
    freeMem mimeType'
    return result'


-- function g_content_type_is_a
-- Args : [Arg {argCName = "type", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a content type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "supertype", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a content type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_content_type_is_a" g_content_type_is_a ::
    CString ->                              -- type : TBasicType TUTF8
    CString ->                              -- supertype : TBasicType TUTF8
    IO CInt

{- |
Determines if /@type@/ is a subset of /@supertype@/.
-}
contentTypeIsA ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@type@/: a content type string -}
    -> T.Text
    {- ^ /@supertype@/: a content type string -}
    -> m Bool
    {- ^ __Returns:__ 'True' if /@type@/ is a kind of /@supertype@/,
    'False' otherwise. -}
contentTypeIsA type_ supertype = liftIO $ do
    type_' <- textToCString type_
    supertype' <- textToCString supertype
    result <- g_content_type_is_a type_' supertype'
    let result' = (/= 0) result
    freeMem type_'
    freeMem supertype'
    return result'


-- function g_content_type_guess_for_tree
-- Args : [Arg {argCName = "root", argType = TInterface (Name {namespace = "Gio", name = "File"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the root of the tree to guess a type for", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TCArray True (-1) (-1) (TBasicType TUTF8))
-- throws : False
-- Skip return : False

foreign import ccall "g_content_type_guess_for_tree" g_content_type_guess_for_tree ::
    Ptr Gio.File.File ->                    -- root : TInterface (Name {namespace = "Gio", name = "File"})
    IO (Ptr CString)

{- |
Tries to guess the type of the tree with root /@root@/, by
looking at the files it contains. The result is an array
of content types, with the best guess coming first.

The types returned all have the form x-content\/foo, e.g.
x-content\/audio-cdda (for audio CDs) or x-content\/image-dcf
(for a camera memory card). See the
<http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec shared-mime-info>
specification for more on x-content types.

This function is useful in the implementation of
'GI.Gio.Interfaces.Mount.mountGuessContentType'.

/Since: 2.18/
-}
contentTypeGuessForTree ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.File.IsFile a) =>
    a
    {- ^ /@root@/: the root of the tree to guess a type for -}
    -> m [T.Text]
    {- ^ __Returns:__ an 'Nothing'-terminated
    array of zero or more content types. Free with 'GI.GLib.Functions.strfreev' -}
contentTypeGuessForTree root = liftIO $ do
    root' <- unsafeManagedPtrCastPtr root
    result <- g_content_type_guess_for_tree root'
    checkUnexpectedReturnNULL "contentTypeGuessForTree" result
    result' <- unpackZeroTerminatedUTF8CArray result
    mapZeroTerminatedCArray freeMem result
    freeMem result
    touchManagedPtr root
    return result'


-- function g_content_type_guess
-- Args : [Arg {argCName = "filename", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "a string, or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "data", argType = TCArray False (-1) 2 (TBasicType TUInt8), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "a stream of data, or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "data_size", argType = TBasicType TUInt64, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the size of @data", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "result_uncertain", argType = TBasicType TBoolean, direction = DirectionOut, mayBeNull = False, argDoc = Documentation {rawDocText = Just "return location for the certainty\n    of the result, or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferEverything}]
-- Lengths : [Arg {argCName = "data_size", argType = TBasicType TUInt64, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the size of @data", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False

foreign import ccall "g_content_type_guess" g_content_type_guess ::
    CString ->                              -- filename : TBasicType TUTF8
    Ptr Word8 ->                            -- data : TCArray False (-1) 2 (TBasicType TUInt8)
    Word64 ->                               -- data_size : TBasicType TUInt64
    Ptr CInt ->                             -- result_uncertain : TBasicType TBoolean
    IO CString

{- |
Guesses the content type based on example data. If the function is
uncertain, /@resultUncertain@/ will be set to 'True'. Either /@filename@/
or /@data@/ may be 'Nothing', in which case the guess will be based solely
on the other argument.
-}
contentTypeGuess ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Maybe (T.Text)
    {- ^ /@filename@/: a string, or 'Nothing' -}
    -> Maybe (ByteString)
    {- ^ /@data@/: a stream of data, or 'Nothing' -}
    -> m ((T.Text, Bool))
    {- ^ __Returns:__ a string indicating a guessed content type for the
    given data. Free with 'GI.GLib.Functions.free' -}
contentTypeGuess filename data_ = liftIO $ do
    let dataSize = case data_ of
            Nothing -> 0
            Just jData_ -> fromIntegral $ B.length jData_
    maybeFilename <- case filename of
        Nothing -> return nullPtr
        Just jFilename -> do
            jFilename' <- textToCString jFilename
            return jFilename'
    maybeData_ <- case data_ of
        Nothing -> return nullPtr
        Just jData_ -> do
            jData_' <- packByteString jData_
            return jData_'
    resultUncertain <- allocMem :: IO (Ptr CInt)
    result <- g_content_type_guess maybeFilename maybeData_ dataSize resultUncertain
    checkUnexpectedReturnNULL "contentTypeGuess" result
    result' <- cstringToText result
    freeMem result
    resultUncertain' <- peek resultUncertain
    let resultUncertain'' = (/= 0) resultUncertain'
    freeMem maybeFilename
    freeMem maybeData_
    freeMem resultUncertain
    return (result', resultUncertain'')


-- function g_content_type_get_symbolic_icon
-- Args : [Arg {argCName = "type", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a content type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "Icon"}))
-- throws : False
-- Skip return : False

foreign import ccall "g_content_type_get_symbolic_icon" g_content_type_get_symbolic_icon ::
    CString ->                              -- type : TBasicType TUTF8
    IO (Ptr Gio.Icon.Icon)

{- |
Gets the symbolic icon for a content type.

/Since: 2.34/
-}
contentTypeGetSymbolicIcon ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@type@/: a content type string -}
    -> m Gio.Icon.Icon
    {- ^ __Returns:__ symbolic 'GI.Gio.Interfaces.Icon.Icon' corresponding to the content type.
    Free the returned object with 'GI.GObject.Objects.Object.objectUnref' -}
contentTypeGetSymbolicIcon type_ = liftIO $ do
    type_' <- textToCString type_
    result <- g_content_type_get_symbolic_icon type_'
    checkUnexpectedReturnNULL "contentTypeGetSymbolicIcon" result
    result' <- (wrapObject Gio.Icon.Icon) result
    freeMem type_'
    return result'


-- function g_content_type_get_mime_type
-- Args : [Arg {argCName = "type", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a content type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False

foreign import ccall "g_content_type_get_mime_type" g_content_type_get_mime_type ::
    CString ->                              -- type : TBasicType TUTF8
    IO CString

{- |
Gets the mime type for the content type, if one is registered.
-}
contentTypeGetMimeType ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@type@/: a content type string -}
    -> m (Maybe T.Text)
    {- ^ __Returns:__ the registered mime type for the given /@type@/,
    or 'Nothing' if unknown. -}
contentTypeGetMimeType type_ = liftIO $ do
    type_' <- textToCString type_
    result <- g_content_type_get_mime_type type_'
    maybeResult <- convertIfNonNull result $ \result' -> do
        result'' <- cstringToText result'
        freeMem result'
        return result''
    freeMem type_'
    return maybeResult


-- function g_content_type_get_icon
-- Args : [Arg {argCName = "type", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a content type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "Icon"}))
-- throws : False
-- Skip return : False

foreign import ccall "g_content_type_get_icon" g_content_type_get_icon ::
    CString ->                              -- type : TBasicType TUTF8
    IO (Ptr Gio.Icon.Icon)

{- |
Gets the icon for a content type.
-}
contentTypeGetIcon ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@type@/: a content type string -}
    -> m Gio.Icon.Icon
    {- ^ __Returns:__ 'GI.Gio.Interfaces.Icon.Icon' corresponding to the content type. Free the returned
    object with 'GI.GObject.Objects.Object.objectUnref' -}
contentTypeGetIcon type_ = liftIO $ do
    type_' <- textToCString type_
    result <- g_content_type_get_icon type_'
    checkUnexpectedReturnNULL "contentTypeGetIcon" result
    result' <- (wrapObject Gio.Icon.Icon) result
    freeMem type_'
    return result'


-- function g_content_type_get_generic_icon_name
-- Args : [Arg {argCName = "type", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a content type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False

foreign import ccall "g_content_type_get_generic_icon_name" g_content_type_get_generic_icon_name ::
    CString ->                              -- type : TBasicType TUTF8
    IO CString

{- |
Gets the generic icon name for a content type.

See the
<http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec shared-mime-info>
specification for more on the generic icon name.

/Since: 2.34/
-}
contentTypeGetGenericIconName ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@type@/: a content type string -}
    -> m (Maybe T.Text)
    {- ^ __Returns:__ the registered generic icon name for the given /@type@/,
    or 'Nothing' if unknown. Free with 'GI.GLib.Functions.free' -}
contentTypeGetGenericIconName type_ = liftIO $ do
    type_' <- textToCString type_
    result <- g_content_type_get_generic_icon_name type_'
    maybeResult <- convertIfNonNull result $ \result' -> do
        result'' <- cstringToText result'
        freeMem result'
        return result''
    freeMem type_'
    return maybeResult


-- function g_content_type_get_description
-- Args : [Arg {argCName = "type", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a content type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False

foreign import ccall "g_content_type_get_description" g_content_type_get_description ::
    CString ->                              -- type : TBasicType TUTF8
    IO CString

{- |
Gets the human readable description of the content type.
-}
contentTypeGetDescription ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@type@/: a content type string -}
    -> m T.Text
    {- ^ __Returns:__ a short description of the content type /@type@/. Free the
    returned string with 'GI.GLib.Functions.free' -}
contentTypeGetDescription type_ = liftIO $ do
    type_' <- textToCString type_
    result <- g_content_type_get_description type_'
    checkUnexpectedReturnNULL "contentTypeGetDescription" result
    result' <- cstringToText result
    freeMem result
    freeMem type_'
    return result'


-- function g_content_type_from_mime_type
-- Args : [Arg {argCName = "mime_type", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a mime type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUTF8)
-- throws : False
-- Skip return : False

foreign import ccall "g_content_type_from_mime_type" g_content_type_from_mime_type ::
    CString ->                              -- mime_type : TBasicType TUTF8
    IO CString

{- |
Tries to find a content type based on the mime type name.

/Since: 2.18/
-}
contentTypeFromMimeType ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@mimeType@/: a mime type string -}
    -> m (Maybe T.Text)
    {- ^ __Returns:__ Newly allocated string with content type or
    'Nothing'. Free with 'GI.GLib.Functions.free' -}
contentTypeFromMimeType mimeType = liftIO $ do
    mimeType' <- textToCString mimeType
    result <- g_content_type_from_mime_type mimeType'
    maybeResult <- convertIfNonNull result $ \result' -> do
        result'' <- cstringToText result'
        freeMem result'
        return result''
    freeMem mimeType'
    return maybeResult


-- function g_content_type_equals
-- Args : [Arg {argCName = "type1", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a content type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "type2", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a content type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_content_type_equals" g_content_type_equals ::
    CString ->                              -- type1 : TBasicType TUTF8
    CString ->                              -- type2 : TBasicType TUTF8
    IO CInt

{- |
Compares two content types for equality.
-}
contentTypeEquals ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@type1@/: a content type string -}
    -> T.Text
    {- ^ /@type2@/: a content type string -}
    -> m Bool
    {- ^ __Returns:__ 'True' if the two strings are identical or equivalent,
    'False' otherwise. -}
contentTypeEquals type1 type2 = liftIO $ do
    type1' <- textToCString type1
    type2' <- textToCString type2
    result <- g_content_type_equals type1' type2'
    let result' = (/= 0) result
    freeMem type1'
    freeMem type2'
    return result'


-- function g_content_type_can_be_executable
-- Args : [Arg {argCName = "type", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a content type string", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TBoolean)
-- throws : False
-- Skip return : False

foreign import ccall "g_content_type_can_be_executable" g_content_type_can_be_executable ::
    CString ->                              -- type : TBasicType TUTF8
    IO CInt

{- |
Checks if a content type can be executable. Note that for instance
things like text files can be executables (i.e. scripts and batch files).
-}
contentTypeCanBeExecutable ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    T.Text
    {- ^ /@type@/: a content type string -}
    -> m Bool
    {- ^ __Returns:__ 'True' if the file type corresponds to a type that
    can be executable, 'False' otherwise. -}
contentTypeCanBeExecutable type_ = liftIO $ do
    type_' <- textToCString type_
    result <- g_content_type_can_be_executable type_'
    let result' = (/= 0) result
    freeMem type_'
    return result'


-- function g_bus_watch_name_on_connection_with_closures
-- Args : [Arg {argCName = "connection", argType = TInterface (Name {namespace = "Gio", name = "DBusConnection"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "A #GDBusConnection.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "name", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "The name (well-known or unique) to watch.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "flags", argType = TInterface (Name {namespace = "Gio", name = "BusNameWatcherFlags"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "Flags from the #GBusNameWatcherFlags enumeration.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "name_appeared_closure", argType = TInterface (Name {namespace = "GObject", name = "Closure"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "#GClosure to invoke when @name is known\nto exist or %NULL.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "name_vanished_closure", argType = TInterface (Name {namespace = "GObject", name = "Closure"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "#GClosure to invoke when @name is known\nto not exist or %NULL.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUInt)
-- throws : False
-- Skip return : False

foreign import ccall "g_bus_watch_name_on_connection_with_closures" g_bus_watch_name_on_connection_with_closures ::
    Ptr Gio.DBusConnection.DBusConnection -> -- connection : TInterface (Name {namespace = "Gio", name = "DBusConnection"})
    CString ->                              -- name : TBasicType TUTF8
    CUInt ->                                -- flags : TInterface (Name {namespace = "Gio", name = "BusNameWatcherFlags"})
    Ptr Closure ->                          -- name_appeared_closure : TInterface (Name {namespace = "GObject", name = "Closure"})
    Ptr Closure ->                          -- name_vanished_closure : TInterface (Name {namespace = "GObject", name = "Closure"})
    IO Word32

{- |
Version of @/g_bus_watch_name_on_connection()/@ using closures instead of callbacks for
easier binding in other languages.

/Since: 2.26/
-}
busWatchNameOnConnection ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.DBusConnection.IsDBusConnection a) =>
    a
    {- ^ /@connection@/: A 'GI.Gio.Objects.DBusConnection.DBusConnection'. -}
    -> T.Text
    {- ^ /@name@/: The name (well-known or unique) to watch. -}
    -> [Gio.Flags.BusNameWatcherFlags]
    {- ^ /@flags@/: Flags from the 'GI.Gio.Flags.BusNameWatcherFlags' enumeration. -}
    -> Maybe (Closure)
    {- ^ /@nameAppearedClosure@/: 'GI.GObject.Structs.Closure.Closure' to invoke when /@name@/ is known
to exist or 'Nothing'. -}
    -> Maybe (Closure)
    {- ^ /@nameVanishedClosure@/: 'GI.GObject.Structs.Closure.Closure' to invoke when /@name@/ is known
to not exist or 'Nothing'. -}
    -> m Word32
    {- ^ __Returns:__ An identifier (never 0) that an be used with
'GI.Gio.Functions.busUnwatchName' to stop watching the name. -}
busWatchNameOnConnection connection name flags nameAppearedClosure nameVanishedClosure = liftIO $ do
    connection' <- unsafeManagedPtrCastPtr connection
    name' <- textToCString name
    let flags' = gflagsToWord flags
    maybeNameAppearedClosure <- case nameAppearedClosure of
        Nothing -> return nullPtr
        Just jNameAppearedClosure -> do
            jNameAppearedClosure' <- unsafeManagedPtrGetPtr jNameAppearedClosure
            return jNameAppearedClosure'
    maybeNameVanishedClosure <- case nameVanishedClosure of
        Nothing -> return nullPtr
        Just jNameVanishedClosure -> do
            jNameVanishedClosure' <- unsafeManagedPtrGetPtr jNameVanishedClosure
            return jNameVanishedClosure'
    result <- g_bus_watch_name_on_connection_with_closures connection' name' flags' maybeNameAppearedClosure maybeNameVanishedClosure
    touchManagedPtr connection
    whenJust nameAppearedClosure touchManagedPtr
    whenJust nameVanishedClosure touchManagedPtr
    freeMem name'
    return result


-- function g_bus_watch_name_with_closures
-- Args : [Arg {argCName = "bus_type", argType = TInterface (Name {namespace = "Gio", name = "BusType"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "The type of bus to watch a name on.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "name", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "The name (well-known or unique) to watch.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "flags", argType = TInterface (Name {namespace = "Gio", name = "BusNameWatcherFlags"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "Flags from the #GBusNameWatcherFlags enumeration.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "name_appeared_closure", argType = TInterface (Name {namespace = "GObject", name = "Closure"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "#GClosure to invoke when @name is known\nto exist or %NULL.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "name_vanished_closure", argType = TInterface (Name {namespace = "GObject", name = "Closure"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "#GClosure to invoke when @name is known\nto not exist or %NULL.", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUInt)
-- throws : False
-- Skip return : False

foreign import ccall "g_bus_watch_name_with_closures" g_bus_watch_name_with_closures ::
    CUInt ->                                -- bus_type : TInterface (Name {namespace = "Gio", name = "BusType"})
    CString ->                              -- name : TBasicType TUTF8
    CUInt ->                                -- flags : TInterface (Name {namespace = "Gio", name = "BusNameWatcherFlags"})
    Ptr Closure ->                          -- name_appeared_closure : TInterface (Name {namespace = "GObject", name = "Closure"})
    Ptr Closure ->                          -- name_vanished_closure : TInterface (Name {namespace = "GObject", name = "Closure"})
    IO Word32

{- |
Version of @/g_bus_watch_name()/@ using closures instead of callbacks for
easier binding in other languages.

/Since: 2.26/
-}
busWatchName ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.Enums.BusType
    {- ^ /@busType@/: The type of bus to watch a name on. -}
    -> T.Text
    {- ^ /@name@/: The name (well-known or unique) to watch. -}
    -> [Gio.Flags.BusNameWatcherFlags]
    {- ^ /@flags@/: Flags from the 'GI.Gio.Flags.BusNameWatcherFlags' enumeration. -}
    -> Maybe (Closure)
    {- ^ /@nameAppearedClosure@/: 'GI.GObject.Structs.Closure.Closure' to invoke when /@name@/ is known
to exist or 'Nothing'. -}
    -> Maybe (Closure)
    {- ^ /@nameVanishedClosure@/: 'GI.GObject.Structs.Closure.Closure' to invoke when /@name@/ is known
to not exist or 'Nothing'. -}
    -> m Word32
    {- ^ __Returns:__ An identifier (never 0) that an be used with
'GI.Gio.Functions.busUnwatchName' to stop watching the name. -}
busWatchName busType name flags nameAppearedClosure nameVanishedClosure = liftIO $ do
    let busType' = (fromIntegral . fromEnum) busType
    name' <- textToCString name
    let flags' = gflagsToWord flags
    maybeNameAppearedClosure <- case nameAppearedClosure of
        Nothing -> return nullPtr
        Just jNameAppearedClosure -> do
            jNameAppearedClosure' <- unsafeManagedPtrGetPtr jNameAppearedClosure
            return jNameAppearedClosure'
    maybeNameVanishedClosure <- case nameVanishedClosure of
        Nothing -> return nullPtr
        Just jNameVanishedClosure -> do
            jNameVanishedClosure' <- unsafeManagedPtrGetPtr jNameVanishedClosure
            return jNameVanishedClosure'
    result <- g_bus_watch_name_with_closures busType' name' flags' maybeNameAppearedClosure maybeNameVanishedClosure
    whenJust nameAppearedClosure touchManagedPtr
    whenJust nameVanishedClosure touchManagedPtr
    freeMem name'
    return result


-- function g_bus_unwatch_name
-- Args : [Arg {argCName = "watcher_id", argType = TBasicType TUInt, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "An identifier obtained from g_bus_watch_name()", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_bus_unwatch_name" g_bus_unwatch_name ::
    Word32 ->                               -- watcher_id : TBasicType TUInt
    IO ()

{- |
Stops watching a name.

/Since: 2.26/
-}
busUnwatchName ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Word32
    {- ^ /@watcherId@/: An identifier obtained from @/g_bus_watch_name()/@ -}
    -> m ()
busUnwatchName watcherId = liftIO $ do
    g_bus_unwatch_name watcherId
    return ()


-- function g_bus_unown_name
-- Args : [Arg {argCName = "owner_id", argType = TBasicType TUInt, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "an identifier obtained from g_bus_own_name()", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_bus_unown_name" g_bus_unown_name ::
    Word32 ->                               -- owner_id : TBasicType TUInt
    IO ()

{- |
Stops owning a name.

/Since: 2.26/
-}
busUnownName ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Word32
    {- ^ /@ownerId@/: an identifier obtained from @/g_bus_own_name()/@ -}
    -> m ()
busUnownName ownerId = liftIO $ do
    g_bus_unown_name ownerId
    return ()


-- function g_bus_own_name_on_connection_with_closures
-- Args : [Arg {argCName = "connection", argType = TInterface (Name {namespace = "Gio", name = "DBusConnection"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GDBusConnection", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "name", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the well-known name to own", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "flags", argType = TInterface (Name {namespace = "Gio", name = "BusNameOwnerFlags"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a set of flags from the #GBusNameOwnerFlags enumeration", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "name_acquired_closure", argType = TInterface (Name {namespace = "GObject", name = "Closure"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "#GClosure to invoke when @name is\n    acquired or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "name_lost_closure", argType = TInterface (Name {namespace = "GObject", name = "Closure"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "#GClosure to invoke when @name is lost\n    or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUInt)
-- throws : False
-- Skip return : False

foreign import ccall "g_bus_own_name_on_connection_with_closures" g_bus_own_name_on_connection_with_closures ::
    Ptr Gio.DBusConnection.DBusConnection -> -- connection : TInterface (Name {namespace = "Gio", name = "DBusConnection"})
    CString ->                              -- name : TBasicType TUTF8
    CUInt ->                                -- flags : TInterface (Name {namespace = "Gio", name = "BusNameOwnerFlags"})
    Ptr Closure ->                          -- name_acquired_closure : TInterface (Name {namespace = "GObject", name = "Closure"})
    Ptr Closure ->                          -- name_lost_closure : TInterface (Name {namespace = "GObject", name = "Closure"})
    IO Word32

{- |
Version of @/g_bus_own_name_on_connection()/@ using closures instead of
callbacks for easier binding in other languages.

/Since: 2.26/
-}
busOwnNameOnConnection ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.DBusConnection.IsDBusConnection a) =>
    a
    {- ^ /@connection@/: a 'GI.Gio.Objects.DBusConnection.DBusConnection' -}
    -> T.Text
    {- ^ /@name@/: the well-known name to own -}
    -> [Gio.Flags.BusNameOwnerFlags]
    {- ^ /@flags@/: a set of flags from the 'GI.Gio.Flags.BusNameOwnerFlags' enumeration -}
    -> Maybe (Closure)
    {- ^ /@nameAcquiredClosure@/: 'GI.GObject.Structs.Closure.Closure' to invoke when /@name@/ is
    acquired or 'Nothing' -}
    -> Maybe (Closure)
    {- ^ /@nameLostClosure@/: 'GI.GObject.Structs.Closure.Closure' to invoke when /@name@/ is lost
    or 'Nothing' -}
    -> m Word32
    {- ^ __Returns:__ an identifier (never 0) that an be used with
    'GI.Gio.Functions.busUnownName' to stop owning the name. -}
busOwnNameOnConnection connection name flags nameAcquiredClosure nameLostClosure = liftIO $ do
    connection' <- unsafeManagedPtrCastPtr connection
    name' <- textToCString name
    let flags' = gflagsToWord flags
    maybeNameAcquiredClosure <- case nameAcquiredClosure of
        Nothing -> return nullPtr
        Just jNameAcquiredClosure -> do
            jNameAcquiredClosure' <- unsafeManagedPtrGetPtr jNameAcquiredClosure
            return jNameAcquiredClosure'
    maybeNameLostClosure <- case nameLostClosure of
        Nothing -> return nullPtr
        Just jNameLostClosure -> do
            jNameLostClosure' <- unsafeManagedPtrGetPtr jNameLostClosure
            return jNameLostClosure'
    result <- g_bus_own_name_on_connection_with_closures connection' name' flags' maybeNameAcquiredClosure maybeNameLostClosure
    touchManagedPtr connection
    whenJust nameAcquiredClosure touchManagedPtr
    whenJust nameLostClosure touchManagedPtr
    freeMem name'
    return result


-- function g_bus_own_name_with_closures
-- Args : [Arg {argCName = "bus_type", argType = TInterface (Name {namespace = "Gio", name = "BusType"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the type of bus to own a name on", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "name", argType = TBasicType TUTF8, direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "the well-known name to own", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "flags", argType = TInterface (Name {namespace = "Gio", name = "BusNameOwnerFlags"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a set of flags from the #GBusNameOwnerFlags enumeration", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "bus_acquired_closure", argType = TInterface (Name {namespace = "GObject", name = "Closure"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "#GClosure to invoke when connected to\n    the bus of type @bus_type or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "name_acquired_closure", argType = TInterface (Name {namespace = "GObject", name = "Closure"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "#GClosure to invoke when @name is\n    acquired or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "name_lost_closure", argType = TInterface (Name {namespace = "GObject", name = "Closure"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "#GClosure to invoke when @name is lost or\n    %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TBasicType TUInt)
-- throws : False
-- Skip return : False

foreign import ccall "g_bus_own_name_with_closures" g_bus_own_name_with_closures ::
    CUInt ->                                -- bus_type : TInterface (Name {namespace = "Gio", name = "BusType"})
    CString ->                              -- name : TBasicType TUTF8
    CUInt ->                                -- flags : TInterface (Name {namespace = "Gio", name = "BusNameOwnerFlags"})
    Ptr Closure ->                          -- bus_acquired_closure : TInterface (Name {namespace = "GObject", name = "Closure"})
    Ptr Closure ->                          -- name_acquired_closure : TInterface (Name {namespace = "GObject", name = "Closure"})
    Ptr Closure ->                          -- name_lost_closure : TInterface (Name {namespace = "GObject", name = "Closure"})
    IO Word32

{- |
Version of @/g_bus_own_name()/@ using closures instead of callbacks for
easier binding in other languages.

/Since: 2.26/
-}
busOwnName ::
    (B.CallStack.HasCallStack, MonadIO m) =>
    Gio.Enums.BusType
    {- ^ /@busType@/: the type of bus to own a name on -}
    -> T.Text
    {- ^ /@name@/: the well-known name to own -}
    -> [Gio.Flags.BusNameOwnerFlags]
    {- ^ /@flags@/: a set of flags from the 'GI.Gio.Flags.BusNameOwnerFlags' enumeration -}
    -> Maybe (Closure)
    {- ^ /@busAcquiredClosure@/: 'GI.GObject.Structs.Closure.Closure' to invoke when connected to
    the bus of type /@busType@/ or 'Nothing' -}
    -> Maybe (Closure)
    {- ^ /@nameAcquiredClosure@/: 'GI.GObject.Structs.Closure.Closure' to invoke when /@name@/ is
    acquired or 'Nothing' -}
    -> Maybe (Closure)
    {- ^ /@nameLostClosure@/: 'GI.GObject.Structs.Closure.Closure' to invoke when /@name@/ is lost or
    'Nothing' -}
    -> m Word32
    {- ^ __Returns:__ an identifier (never 0) that an be used with
    'GI.Gio.Functions.busUnownName' to stop owning the name. -}
busOwnName busType name flags busAcquiredClosure nameAcquiredClosure nameLostClosure = liftIO $ do
    let busType' = (fromIntegral . fromEnum) busType
    name' <- textToCString name
    let flags' = gflagsToWord flags
    maybeBusAcquiredClosure <- case busAcquiredClosure of
        Nothing -> return nullPtr
        Just jBusAcquiredClosure -> do
            jBusAcquiredClosure' <- unsafeManagedPtrGetPtr jBusAcquiredClosure
            return jBusAcquiredClosure'
    maybeNameAcquiredClosure <- case nameAcquiredClosure of
        Nothing -> return nullPtr
        Just jNameAcquiredClosure -> do
            jNameAcquiredClosure' <- unsafeManagedPtrGetPtr jNameAcquiredClosure
            return jNameAcquiredClosure'
    maybeNameLostClosure <- case nameLostClosure of
        Nothing -> return nullPtr
        Just jNameLostClosure -> do
            jNameLostClosure' <- unsafeManagedPtrGetPtr jNameLostClosure
            return jNameLostClosure'
    result <- g_bus_own_name_with_closures busType' name' flags' maybeBusAcquiredClosure maybeNameAcquiredClosure maybeNameLostClosure
    whenJust busAcquiredClosure touchManagedPtr
    whenJust nameAcquiredClosure touchManagedPtr
    whenJust nameLostClosure touchManagedPtr
    freeMem name'
    return result


-- function g_bus_get_sync
-- Args : [Arg {argCName = "bus_type", argType = TInterface (Name {namespace = "Gio", name = "BusType"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GBusType", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "cancellable", argType = TInterface (Name {namespace = "Gio", name = "Cancellable"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "a #GCancellable or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "DBusConnection"}))
-- throws : True
-- Skip return : False

foreign import ccall "g_bus_get_sync" g_bus_get_sync ::
    CUInt ->                                -- bus_type : TInterface (Name {namespace = "Gio", name = "BusType"})
    Ptr Gio.Cancellable.Cancellable ->      -- cancellable : TInterface (Name {namespace = "Gio", name = "Cancellable"})
    Ptr (Ptr GError) ->                     -- error
    IO (Ptr Gio.DBusConnection.DBusConnection)

{- |
Synchronously connects to the message bus specified by /@busType@/.
Note that the returned object may shared with other callers,
e.g. if two separate parts of a process calls this function with
the same /@busType@/, they will share the same object.

This is a synchronous failable function. See 'GI.Gio.Functions.busGet' and
'GI.Gio.Functions.busGetFinish' for the asynchronous version.

The returned object is a singleton, that is, shared with other
callers of 'GI.Gio.Functions.busGet' and 'GI.Gio.Functions.busGetSync' for /@busType@/. In the
event that you need a private message bus connection, use
'GI.Gio.Functions.dbusAddressGetForBusSync' and
'GI.Gio.Objects.DBusConnection.dBusConnectionNewForAddress'.

Note that the returned 'GI.Gio.Objects.DBusConnection.DBusConnection' object will (usually) have
the 'GI.Gio.Objects.DBusConnection.DBusConnection':@/exit-on-close/@ property set to 'True'.

/Since: 2.26/
-}
busGetSync ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.Cancellable.IsCancellable a) =>
    Gio.Enums.BusType
    {- ^ /@busType@/: a 'GI.Gio.Enums.BusType' -}
    -> Maybe (a)
    {- ^ /@cancellable@/: a 'GI.Gio.Objects.Cancellable.Cancellable' or 'Nothing' -}
    -> m Gio.DBusConnection.DBusConnection
    {- ^ __Returns:__ a 'GI.Gio.Objects.DBusConnection.DBusConnection' or 'Nothing' if /@error@/ is set.
    Free with 'GI.GObject.Objects.Object.objectUnref'. /(Can throw 'Data.GI.Base.GError.GError')/ -}
busGetSync busType cancellable = liftIO $ do
    let busType' = (fromIntegral . fromEnum) busType
    maybeCancellable <- case cancellable of
        Nothing -> return nullPtr
        Just jCancellable -> do
            jCancellable' <- unsafeManagedPtrCastPtr jCancellable
            return jCancellable'
    onException (do
        result <- propagateGError $ g_bus_get_sync busType' maybeCancellable
        checkUnexpectedReturnNULL "busGetSync" result
        result' <- (wrapObject Gio.DBusConnection.DBusConnection) result
        whenJust cancellable touchManagedPtr
        return result'
     ) (do
        return ()
     )


-- function g_bus_get_finish
-- Args : [Arg {argCName = "res", argType = TInterface (Name {namespace = "Gio", name = "AsyncResult"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GAsyncResult obtained from the #GAsyncReadyCallback passed\n    to g_bus_get()", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Just (TInterface (Name {namespace = "Gio", name = "DBusConnection"}))
-- throws : True
-- Skip return : False

foreign import ccall "g_bus_get_finish" g_bus_get_finish ::
    Ptr Gio.AsyncResult.AsyncResult ->      -- res : TInterface (Name {namespace = "Gio", name = "AsyncResult"})
    Ptr (Ptr GError) ->                     -- error
    IO (Ptr Gio.DBusConnection.DBusConnection)

{- |
Finishes an operation started with 'GI.Gio.Functions.busGet'.

The returned object is a singleton, that is, shared with other
callers of 'GI.Gio.Functions.busGet' and 'GI.Gio.Functions.busGetSync' for /@busType@/. In the
event that you need a private message bus connection, use
'GI.Gio.Functions.dbusAddressGetForBusSync' and
'GI.Gio.Objects.DBusConnection.dBusConnectionNewForAddress'.

Note that the returned 'GI.Gio.Objects.DBusConnection.DBusConnection' object will (usually) have
the 'GI.Gio.Objects.DBusConnection.DBusConnection':@/exit-on-close/@ property set to 'True'.

/Since: 2.26/
-}
busGetFinish ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.AsyncResult.IsAsyncResult a) =>
    a
    {- ^ /@res@/: a 'GI.Gio.Interfaces.AsyncResult.AsyncResult' obtained from the 'GI.Gio.Callbacks.AsyncReadyCallback' passed
    to 'GI.Gio.Functions.busGet' -}
    -> m Gio.DBusConnection.DBusConnection
    {- ^ __Returns:__ a 'GI.Gio.Objects.DBusConnection.DBusConnection' or 'Nothing' if /@error@/ is set.
    Free with 'GI.GObject.Objects.Object.objectUnref'. /(Can throw 'Data.GI.Base.GError.GError')/ -}
busGetFinish res = liftIO $ do
    res' <- unsafeManagedPtrCastPtr res
    onException (do
        result <- propagateGError $ g_bus_get_finish res'
        checkUnexpectedReturnNULL "busGetFinish" result
        result' <- (wrapObject Gio.DBusConnection.DBusConnection) result
        touchManagedPtr res
        return result'
     ) (do
        return ()
     )


-- function g_bus_get
-- Args : [Arg {argCName = "bus_type", argType = TInterface (Name {namespace = "Gio", name = "BusType"}), direction = DirectionIn, mayBeNull = False, argDoc = Documentation {rawDocText = Just "a #GBusType", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "cancellable", argType = TInterface (Name {namespace = "Gio", name = "Cancellable"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "a #GCancellable or %NULL", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "callback", argType = TInterface (Name {namespace = "Gio", name = "AsyncReadyCallback"}), direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "a #GAsyncReadyCallback to call when the request is satisfied", sinceVersion = Nothing}, argScope = ScopeTypeAsync, argClosure = 3, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing},Arg {argCName = "user_data", argType = TBasicType TPtr, direction = DirectionIn, mayBeNull = True, argDoc = Documentation {rawDocText = Just "the data to pass to @callback", sinceVersion = Nothing}, argScope = ScopeTypeInvalid, argClosure = -1, argDestroy = -1, argCallerAllocates = False, transfer = TransferNothing}]
-- Lengths : []
-- returnType : Nothing
-- throws : False
-- Skip return : False

foreign import ccall "g_bus_get" g_bus_get ::
    CUInt ->                                -- bus_type : TInterface (Name {namespace = "Gio", name = "BusType"})
    Ptr Gio.Cancellable.Cancellable ->      -- cancellable : TInterface (Name {namespace = "Gio", name = "Cancellable"})
    FunPtr Gio.Callbacks.C_AsyncReadyCallback -> -- callback : TInterface (Name {namespace = "Gio", name = "AsyncReadyCallback"})
    Ptr () ->                               -- user_data : TBasicType TPtr
    IO ()

{- |
Asynchronously connects to the message bus specified by /@busType@/.

When the operation is finished, /@callback@/ will be invoked. You can
then call 'GI.Gio.Functions.busGetFinish' to get the result of the operation.

This is a asynchronous failable function. See 'GI.Gio.Functions.busGetSync' for
the synchronous version.

/Since: 2.26/
-}
busGet ::
    (B.CallStack.HasCallStack, MonadIO m, Gio.Cancellable.IsCancellable a) =>
    Gio.Enums.BusType
    {- ^ /@busType@/: a 'GI.Gio.Enums.BusType' -}
    -> Maybe (a)
    {- ^ /@cancellable@/: a 'GI.Gio.Objects.Cancellable.Cancellable' or 'Nothing' -}
    -> Maybe (Gio.Callbacks.AsyncReadyCallback)
    {- ^ /@callback@/: a 'GI.Gio.Callbacks.AsyncReadyCallback' to call when the request is satisfied -}
    -> m ()
busGet busType cancellable callback = liftIO $ do
    let busType' = (fromIntegral . fromEnum) busType
    maybeCancellable <- case cancellable of
        Nothing -> return nullPtr
        Just jCancellable -> do
            jCancellable' <- unsafeManagedPtrCastPtr jCancellable
            return jCancellable'
    maybeCallback <- case callback of
        Nothing -> return (castPtrToFunPtr nullPtr)
        Just jCallback -> do
            ptrcallback <- callocMem :: IO (Ptr (FunPtr Gio.Callbacks.C_AsyncReadyCallback))
            jCallback' <- Gio.Callbacks.mk_AsyncReadyCallback (Gio.Callbacks.wrap_AsyncReadyCallback (Just ptrcallback) (Gio.Callbacks.drop_closures_AsyncReadyCallback jCallback))
            poke ptrcallback jCallback'
            return jCallback'
    let userData = nullPtr
    g_bus_get busType' maybeCancellable maybeCallback userData
    whenJust cancellable touchManagedPtr
    return ()