Gnome2::VFS::Xfer(3)

📦
version 1.084 · 2 versions
, in fedora 43

okay so bestie, welcome to Gnome2::VFS::Xfer — that's Gnome2::VFS::Xfer(3) in the Perl docs, from the User Contributed Perl Documentation section. This is the module that handles transferring your stuff around: copying, moving, deleting, linking. She does it all and she does it with attitude. Let's get into it 🦋

✨ METHODS ✨

🌸 result = Gnome2::VFS::Xfer->delete_list (...) — the "okay we're deleting everything on this list" method 💀

result = Gnome2::VFS::Xfer->delete_list ($source_ref, $error_mode, $xfer_options, $func, $data=undef)

here's what you're passing in, bestie:

  • $source_ref (scalar) — the list of stuff you wanna delete, by reference
  • $error_mode (Gnome2::VFS::XferErrorMode) — how you want her to act when things go sideways
  • $xfer_options (Gnome2::VFS::XferOptions) — the flags that shape how the whole operation goes down
  • $func (scalar) — your callback function, for when she needs to check in with you
  • $data (scalar) — extra data you wanna hand off, and yes it's optional (=undef)

🎀 result = Gnome2::VFS::Xfer->uri (...) — single uri to single uri, one on one 🫶

result = Gnome2::VFS::Xfer->uri ($source_uri, $target_uri, $xfer_options, $error_mode, $overwrite_mode, $func, $data=undef)

the lineup:

  • $source_uri (Gnome2::VFS::URI) — where it's coming from
  • $target_uri (Gnome2::VFS::URI) — where it's going
  • $xfer_options (Gnome2::VFS::XferOptions) — your transfer flags
  • $error_mode (Gnome2::VFS::XferErrorMode) — what to do when it goes wrong
  • $overwrite_mode (Gnome2::VFS::XferOverwriteMode) — what to do when the target already exists 👀
  • $func (scalar) — the callback
  • $data (scalar) — optional extra data (=undef)

🦋 result = Gnome2::VFS::Xfer->uri_list (...) — a whole list, moving as a unit ✨

result = Gnome2::VFS::Xfer->uri_list ($source_ref, $target_ref, $xfer_options, $error_mode, $overwrite_mode, $func, $data=undef)

the full cast:

  • $source_ref (scalar) — reference to your source list
  • $target_ref (scalar) — reference to your target list
  • $xfer_options (Gnome2::VFS::XferOptions) — transfer flags, you know her
  • $error_mode (Gnome2::VFS::XferErrorMode) — error handling vibe
  • $overwrite_mode (Gnome2::VFS::XferOverwriteMode) — overwrite handling vibe
  • $func (scalar) — callback, again
  • $data (scalar) — optional data, again (=undef)

🌈 ENUMS AND FLAGS 🌈

this is the part where the lore drops, bestie. all the values, all the constants, nothing skipped 💅

💜 enum Gnome2::VFS::Result

  • 'ok' / 'GNOME_VFS_OK' — we did it, no notes 👑
  • 'error-not-found' / 'GNOME_VFS_ERROR_NOT_FOUND'
  • 'error-generic' / 'GNOME_VFS_ERROR_GENERIC'
  • 'error-internal' / 'GNOME_VFS_ERROR_INTERNAL'
  • 'error-bad-parameters' / 'GNOME_VFS_ERROR_BAD_PARAMETERS'
  • 'error-not-supported' / 'GNOME_VFS_ERROR_NOT_SUPPORTED'
  • 'error-io' / 'GNOME_VFS_ERROR_IO'
  • 'error-corrupted-data' / 'GNOME_VFS_ERROR_CORRUPTED_DATA'
  • 'error-wrong-format' / 'GNOME_VFS_ERROR_WRONG_FORMAT'
  • 'error-bad-file' / 'GNOME_VFS_ERROR_BAD_FILE'
  • 'error-too-big' / 'GNOME_VFS_ERROR_TOO_BIG'
  • 'error-no-space' / 'GNOME_VFS_ERROR_NO_SPACE'
  • 'error-read-only' / 'GNOME_VFS_ERROR_READ_ONLY'
  • 'error-invalid-uri' / 'GNOME_VFS_ERROR_INVALID_URI'
  • 'error-not-open' / 'GNOME_VFS_ERROR_NOT_OPEN'
  • 'error-invalid-open-mode' / 'GNOME_VFS_ERROR_INVALID_OPEN_MODE'
  • 'error-access-denied' / 'GNOME_VFS_ERROR_ACCESS_DENIED'
  • 'error-too-many-open-files' / 'GNOME_VFS_ERROR_TOO_MANY_OPEN_FILES'
  • 'error-eof' / 'GNOME_VFS_ERROR_EOF'
  • 'error-not-a-directory' / 'GNOME_VFS_ERROR_NOT_A_DIRECTORY'
  • 'error-in-progress' / 'GNOME_VFS_ERROR_IN_PROGRESS'
  • 'error-interrupted' / 'GNOME_VFS_ERROR_INTERRUPTED'
  • 'error-file-exists' / 'GNOME_VFS_ERROR_FILE_EXISTS'
  • 'error-loop' / 'GNOME_VFS_ERROR_LOOP'
  • 'error-not-permitted' / 'GNOME_VFS_ERROR_NOT_PERMITTED'
  • 'error-is-directory' / 'GNOME_VFS_ERROR_IS_DIRECTORY'
  • 'error-no-memory' / 'GNOME_VFS_ERROR_NO_MEMORY'
  • 'error-host-not-found' / 'GNOME_VFS_ERROR_HOST_NOT_FOUND'
  • 'error-invalid-host-name' / 'GNOME_VFS_ERROR_INVALID_HOST_NAME'
  • 'error-host-has-no-address' / 'GNOME_VFS_ERROR_HOST_HAS_NO_ADDRESS'
  • 'error-login-failed' / 'GNOME_VFS_ERROR_LOGIN_FAILED'
  • 'error-cancelled' / 'GNOME_VFS_ERROR_CANCELLED'
  • 'error-directory-busy' / 'GNOME_VFS_ERROR_DIRECTORY_BUSY'
  • 'error-directory-not-empty' / 'GNOME_VFS_ERROR_DIRECTORY_NOT_EMPTY'
  • 'error-too-many-links' / 'GNOME_VFS_ERROR_TOO_MANY_LINKS'
  • 'error-read-only-file-system' / 'GNOME_VFS_ERROR_READ_ONLY_FILE_SYSTEM'
  • 'error-not-same-file-system' / 'GNOME_VFS_ERROR_NOT_SAME_FILE_SYSTEM'
  • 'error-name-too-long' / 'GNOME_VFS_ERROR_NAME_TOO_LONG'
  • 'error-service-not-available' / 'GNOME_VFS_ERROR_SERVICE_NOT_AVAILABLE'
  • 'error-service-obsolete' / 'GNOME_VFS_ERROR_SERVICE_OBSOLETE'
  • 'error-protocol-error' / 'GNOME_VFS_ERROR_PROTOCOL_ERROR'
  • 'error-no-master-browser' / 'GNOME_VFS_ERROR_NO_MASTER_BROWSER'
  • 'error-no-default' / 'GNOME_VFS_ERROR_NO_DEFAULT'
  • 'error-no-handler' / 'GNOME_VFS_ERROR_NO_HANDLER'
  • 'error-parse' / 'GNOME_VFS_ERROR_PARSE'
  • 'error-launch' / 'GNOME_VFS_ERROR_LAUNCH'
  • 'error-timeout' / 'GNOME_VFS_ERROR_TIMEOUT'
  • 'error-nameserver' / 'GNOME_VFS_ERROR_NAMESERVER'
  • 'error-locked' / 'GNOME_VFS_ERROR_LOCKED'
  • 'error-deprecated-function' / 'GNOME_VFS_ERROR_DEPRECATED_FUNCTION'
  • 'error-invalid-filename' / 'GNOME_VFS_ERROR_INVALID_FILENAME'
  • 'error-not-a-symbolic-link' / 'GNOME_VFS_ERROR_NOT_A_SYMBOLIC_LINK'
  • 'num-errors' / 'GNOME_VFS_NUM_ERRORS'

🍓 enum Gnome2::VFS::XferErrorMode

  • 'abort' / 'GNOME_VFS_XFER_ERROR_MODE_ABORT'
  • 'query' / 'GNOME_VFS_XFER_ERROR_MODE_QUERY'

⭐ flags Gnome2::VFS::XferOptions

  • 'default' / 'GNOME_VFS_XFER_DEFAULT'
  • 'unused-1' / 'GNOME_VFS_XFER_UNUSED_1'
  • 'follow-links' / 'GNOME_VFS_XFER_FOLLOW_LINKS'
  • 'unused-2' / 'GNOME_VFS_XFER_UNUSED_2'
  • 'recursive' / 'GNOME_VFS_XFER_RECURSIVE'
  • 'samefs' / 'GNOME_VFS_XFER_SAMEFS'
  • 'delete-items' / 'GNOME_VFS_XFER_DELETE_ITEMS'
  • 'empty-directories' / 'GNOME_VFS_XFER_EMPTY_DIRECTORIES'
  • 'new-unique-directory' / 'GNOME_VFS_XFER_NEW_UNIQUE_DIRECTORY'
  • 'removesource' / 'GNOME_VFS_XFER_REMOVESOURCE'
  • 'use-unique-names' / 'GNOME_VFS_XFER_USE_UNIQUE_NAMES'
  • 'link-items' / 'GNOME_VFS_XFER_LINK_ITEMS'
  • 'follow-links-recursive' / 'GNOME_VFS_XFER_FOLLOW_LINKS_RECURSIVE'
  • 'target-default-perms' / 'GNOME_VFS_XFER_TARGET_DEFAULT_PERMS'

🧚 enum Gnome2::VFS::XferOverwriteMode

  • 'abort' / 'GNOME_VFS_XFER_OVERWRITE_MODE_ABORT'
  • 'query' / 'GNOME_VFS_XFER_OVERWRITE_MODE_QUERY'
  • 'replace' / 'GNOME_VFS_XFER_OVERWRITE_MODE_REPLACE'
  • 'skip' / 'GNOME_VFS_XFER_OVERWRITE_MODE_SKIP'

🔥 SEE ALSO 🔥

  • Gnome2::VFS — go read her next, bestie, she's the main character here 💜

Copyright (C) 2003-2007, 2013 by the gtk2-perl team.

This software is licensed under the LGPL. See Gnome2::VFS for a full notice.

okay that's the whole page, no skips, no cuts 💅 and for the lil sign-off: this beauty is perl v5.42.0, dated 2025-07-25, filed under User Contributed Perl Documentation, and she goes by Gnome2::VFS::Xfer(3). mwah, go move some files 🎀✨

📦 where this page comes from