Gnome2:...:Handle(3)

📦
version 1.084 · 2 versions
, in fedora 43

💖 NAME 💖

okay so, bestie, this is the page for Gnome2::VFS::Directory::Handle — straight out of the User Contributed Perl Documentation. it's a directory handle object, it does directory-handle things, and it's giving "small API, big feelings" energy. let's get into it 💅

✨ METHODS ✨

🌸 result = $handle->close

closes the handle, and hands you back a result. that's it, that's the whole vibe. one method, zero drama. 🫶

reads the next thing off the list. and listen — it Returns a GnomeVFSResult and a GnomeVFSFileInfo. two things, one call. she's multifaceted like that. 😭✨

🎀 ENUMS AND FLAGS 🎀

🦋 enum Gnome2::VFS::Result

okay this is the big one, the main character of the page. every single result code you could ever get back, in all her glory. buckle up, we're going through all of them, no skipping, no shortcuts, periodt. 👑

  • 'ok' / GNOME_VFS_OK — everything's fine, the vibe check passed, slay 💖
  • 'error-not-found' / GNOME_VFS_ERROR_NOT_FOUND — it's not there, bestie 😭
  • 'error-generic' / GNOME_VFS_ERROR_GENERIC — just... an error. generic. no further comment 🙈
  • 'error-internal' / GNOME_VFS_ERROR_INTERNAL — something broke inside, it's personal now
  • 'error-bad-parameters' / GNOME_VFS_ERROR_BAD_PARAMETERS — you handed it bad parameters, and it's telling you
  • 'error-not-supported' / GNOME_VFS_ERROR_NOT_SUPPORTED — not supported, not happening, not today
  • 'error-io' / GNOME_VFS_ERROR_IO — an I/O thing went sideways
  • 'error-corrupted-data' / GNOME_VFS_ERROR_CORRUPTED_DATA — the data is corrupted 💀
  • 'error-wrong-format' / GNOME_VFS_ERROR_WRONG_FORMAT — wrong format, right energy, unfortunately format is what counts
  • 'error-bad-file' / GNOME_VFS_ERROR_BAD_FILE — bad file. bad. naughty file.
  • 'error-too-big' / GNOME_VFS_ERROR_TOO_BIG — too big, it can't even 🫣
  • 'error-no-space' / GNOME_VFS_ERROR_NO_SPACE — no space left, the classic
  • 'error-read-only' / GNOME_VFS_ERROR_READ_ONLY — read-only, so don't even try it
  • 'error-invalid-uri' / GNOME_VFS_ERROR_INVALID_URI — that URI is invalid, bestie, redo it
  • 'error-not-open' / GNOME_VFS_ERROR_NOT_OPEN — it's not open
  • 'error-invalid-open-mode' / GNOME_VFS_ERROR_INVALID_OPEN_MODE — that open mode? invalid. nope.
  • 'error-access-denied' / GNOME_VFS_ERROR_ACCESS_DENIED — access denied, the bouncer said no 💅
  • 'error-too-many-open-files' / GNOME_VFS_ERROR_TOO_MANY_OPEN_FILES — too many open files, you're hoarding
  • 'error-eof' / GNOME_VFS_ERROR_EOF — end of file, we've reached the end, take a bow 🎀
  • 'error-not-a-directory' / GNOME_VFS_ERROR_NOT_A_DIRECTORY — not a directory. it's not one. stop asking.
  • 'error-in-progress' / GNOME_VFS_ERROR_IN_PROGRESS — it's in progress, give her a minute
  • 'error-interrupted' / GNOME_VFS_ERROR_INTERRUPTED — interrupted 😭
  • 'error-file-exists' / GNOME_VFS_ERROR_FILE_EXISTS — it already exists, it was here first
  • 'error-loop' / GNOME_VFS_ERROR_LOOP — a loop. we're going in circles. literally.
  • 'error-not-permitted' / GNOME_VFS_ERROR_NOT_PERMITTED — not permitted, and that's the final answer
  • 'error-is-directory' / GNOME_VFS_ERROR_IS_DIRECTORY — plot twist: it IS a directory
  • 'error-no-memory' / GNOME_VFS_ERROR_NO_MEMORY — no memory left, she's full 💀
  • 'error-host-not-found' / GNOME_VFS_ERROR_HOST_NOT_FOUND — host not found, where did they go
  • 'error-invalid-host-name' / GNOME_VFS_ERROR_INVALID_HOST_NAME — that host name is invalid
  • 'error-host-has-no-address' / GNOME_VFS_ERROR_HOST_HAS_NO_ADDRESS — the host has no address, she's off the grid
  • 'error-login-failed' / GNOME_VFS_ERROR_LOGIN_FAILED — login failed 🙈
  • 'error-cancelled' / GNOME_VFS_ERROR_CANCELLED — cancelled, we're not doing this anymore
  • 'error-directory-busy' / GNOME_VFS_ERROR_DIRECTORY_BUSY — directory's busy, she's booked and blessed
  • 'error-directory-not-empty' / GNOME_VFS_ERROR_DIRECTORY_NOT_EMPTY — not empty, there's stuff in there
  • 'error-too-many-links' / GNOME_VFS_ERROR_TOO_MANY_LINKS — too many links, it's a whole web
  • 'error-read-only-file-system' / GNOME_VFS_ERROR_READ_ONLY_FILE_SYSTEM — the whole file system is read-only, not just a file
  • 'error-not-same-file-system' / GNOME_VFS_ERROR_NOT_SAME_FILE_SYSTEM — different file systems, different worlds 🌈
  • 'error-name-too-long' / GNOME_VFS_ERROR_NAME_TOO_LONG — that name is too long, ma'am
  • 'error-service-not-available' / GNOME_VFS_ERROR_SERVICE_NOT_AVAILABLE — service not available
  • 'error-service-obsolete' / GNOME_VFS_ERROR_SERVICE_OBSOLETE — that service is obsolete, it's giving 2003
  • 'error-protocol-error' / GNOME_VFS_ERROR_PROTOCOL_ERROR — protocol error, the rules were broken
  • 'error-no-master-browser' / GNOME_VFS_ERROR_NO_MASTER_BROWSER — no master browser 👑 (and no, you can't be it)
  • 'error-no-default' / GNOME_VFS_ERROR_NO_DEFAULT — there's no default
  • 'error-no-handler' / GNOME_VFS_ERROR_NO_HANDLER — no handler, nobody's picking up
  • 'error-parse' / GNOME_VFS_ERROR_PARSE — it couldn't parse it
  • 'error-launch' / GNOME_VFS_ERROR_LAUNCH — the launch failed
  • 'error-timeout' / GNOME_VFS_ERROR_TIMEOUT — timed out, she left you on read
  • 'error-nameserver' / GNOME_VFS_ERROR_NAMESERVER — nameserver said no
  • 'error-locked' / GNOME_VFS_ERROR_LOCKED — locked 🔒
  • 'error-deprecated-function' / GNOME_VFS_ERROR_DEPRECATED_FUNCTION — you called a deprecated function, bestie, it's over
  • 'error-invalid-filename' / GNOME_VFS_ERROR_INVALID_FILENAME — invalid filename, try again with a real one
  • 'error-not-a-symbolic-link' / GNOME_VFS_ERROR_NOT_A_SYMBOLIC_LINK — not a symbolic link. it's not. stop.
  • 'num-errors' / GNOME_VFS_NUM_ERRORS — and that's the count, the finale, the last one 🎀

🦋 SEE ALSO 🦋

  • Gnome2::VFS — go here for the big picture, the mothership, the source of all lore 💖

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

This software is licensed under the LGPL. See Gnome2::VFS for a full notice. (yes, the full notice lives over there, not here — go read it, iykyk ✨)

okay and that's the whole page, bestie!! 🌸 this lil doc came to you courtesy of perl v5.42.0 and it was last touched on 2025-07-25 — so yeah, she's been around, she's seen things, and she still ate 💅🫶 mwah, go close some handles responsibly 🎀

📦 where this page comes from