GLOBUS_GASS_TRANSFER_LISTENERATTR(3)

πŸ“¦
version 9.5 Β· 6 versions
, in epel 10, fedora 43, fedora 44, ubuntu resolute, ubuntu stonking

πŸ’– globus_gass_transfer_listenerattr β€” Listener attributes πŸ’–

okay so bestie, welcome to the globus_gass_transfer_listenerattr(3) page from the Library Functions Manual. this is your little corner of the Globus GASS Transfer world where you get to configure how a listener behaves before it starts listening. attrs. vibes. settings. it's giving "let me customize my listener before it goes live" ✨


πŸŽ€ NAME πŸŽ€

globus_gass_transfer_listenerattr β€” Listener attributes

  • Listener attributes.

that's it. that's the whole name section. short, sweet, iconic. πŸ’…


🌸 SYNOPSIS 🌸

πŸ” Authorization

int globus_gass_transfer_listenerattr_init
    (globus_gass_transfer_listenerattr_t *attr, char *url_scheme)

πŸ“š Listener Backlog

int globus_gass_transfer_listenerattr_set_backlog
    (globus_gass_transfer_listenerattr_t *attr, int backlog)

πŸšͺ Listener Port

int globus_gass_transfer_listenerattr_set_port
    (globus_gass_transfer_listenerattr_t *attr, unsigned short port)

πŸ¦‹ Detailed Description πŸ¦‹

Listener attributes. periodt. these are the knobs and dials you get to twiddle on a GASS Transfer listener attr set β€” like, the stuff that tells a listener how to show up for its job. πŸ’–


✨ Function Documentation ✨

🫢 int globus_gass_transfer_listenerattr_init

(globus_gass_transfer_listenerattr_t * attr, char * url_scheme)

Initialize a listener attribute. no cap, that's literally the whole job.

This function initializes the attr to contain a new protocol-specific listener attribute. so you hand it an empty attr, you tell it which scheme you're gonna use it with, and boom β€” it's a real, protocol-specific thing now. πŸ”₯

πŸ’« Parameters

  • attr β€” The attribute set to be initialized. (the blank canvas, bestie 🎨)
  • url_scheme β€” The scheme which which the attribute will be used for. (yes, the original really does say "which which", we keep it 100 around here 🫢)

🌈 Return values

  • GLOBUS_SUCCESS β€” The attribute was successfully initialized. slay! πŸŽ‰
  • GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER β€” Either attr or url_scheme was GLOBUS_NULL. you passed a nothing. a void. a ghost. πŸ‘»
  • GLOBUS_GASS_TRANSFER_ERROR_NOT_IMPLEMENTED β€” No protocol module currently registered with GASS Transfer Library handles URLs with the specified url_scheme. like, nobody here knows that scheme, sorry babe πŸ’€

πŸ“š int globus_gass_transfer_listenerattr_set_backlog

(globus_gass_transfer_listenerattr_t * attr, int backlog)

Set/Get the backlog attribute for a GASS transfer attribute set.

This attribute allows the user to control then number of pending connections which may exist for this listener. (again β€” "then number", the original's words, we do not edit our queen's typos, we preserve them fr fr 🧚)

πŸ’« Parameters

  • attr β€” The attribute set to query or modify. (look at it OR change it, your call πŸ‘‘)
  • backlog β€” The number of outstanding connections to allow. (how many besties can be waiting in the queue at once πŸŽ€)

🌈 Return values

  • GLOBUS_SUCCESS β€” The attribute was successfully updated. ate. πŸ’…
  • GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER β€” The attr was GLOBUS_NULL. there was no attr to update, bestie, it was void 😭

πŸšͺ int globus_gass_transfer_listenerattr_set_port

(globus_gass_transfer_listenerattr_t * attr, unsigned short port)

Set/Get the port attribute for a GASS transfer attribute set.

This attribute allows the user to set the port to be used by a GASS Transfer listener. pick your door number, that's the one the listener's gonna stand behind. πŸšͺ✨

πŸ’« Parameters

  • attr β€” The attribute set to query or modify. (same energy as above, iconic πŸ’œ)
  • port β€” The TCP or UDP port number to use. (yes, either one, we don't discriminate 🌈)

🌈 Return values

  • GLOBUS_SUCCESS β€” The attribute was successfully updated. periodt. πŸ”₯
  • GLOBUS_GASS_TRANSFER_ERROR_NULL_POINTER β€” The attr was GLOBUS_NULL. no attr, no update, no vibes πŸ’€
heads up bestie: all three of these are int-returning functions, so always check the return value. GLOBUS_SUCCESS is the green flag. anything else is your signal to look at what you passed in. 🚩

πŸ‘‘ Author πŸ‘‘

Generated automatically by Doxygen for globus_gass_transfer from the source code. so technically the author is a robot that reads source code and writes docs, which honestly? main character energy. πŸ€–πŸ’–


aaaand that's the whole page, babe! this was globus_gass_transfer, Version 9.5 β€” documented in the globus_gas...istenerattr(3) page, iykyk. go forth, init your attrs, set your backlog, pick your port, and stay slay. πŸŽ€πŸ’…βœ¨πŸ¦‹πŸŒΈπŸ«Ά