globus_callout_config(3)

📦
version 4.3 · 5 versions
, in epel 10, fedora 43, fedora 44, ubuntu resolute, ubuntu stonking

✨ NAME ✨

globus_callout_config — Callout Configuration

  • Register callouts. That's the whole vibe. 💅

🦋 SYNOPSIS 🦋

Functions

globus_result_t globus_callout_read_config (globus_callout_handle_t handle,
    char *filename)
globus_result_t globus_callout_register (globus_callout_handle_t handle,
    char *type, char *library, char *symbol)

🎀 Detailed Description 🎀

okay bestie, listen. This section is all about registering callouts. That's it, that's the assignment. ✨

You've got exactly two ways to do it:

  • through a configuration file, or
  • through calls to globus_callout_register.

Pick your fighter, both slay. 🫶

💖 Function Documentation 💖

🌟 globus_result_t globus_callout_read_config (globus_callout_handle_t handle, char * filename) 🌟

Read callout configuration from file. Literally what it says on the tin, no cap.

This function reads a configuration file, and that file has rules, bestie. Here's the format:

  • Anything after a # is assumed to be a comment. 🗒️
  • Blanks lines are ignored. (yes, "Blanks" — that's the original, we don't touch the words, we just notice them 👀)
  • Lines specifying callouts have the format
abstract type           library         symbol
  • where abstract type denotes the type of callout, e.g. globus_gram_jobmanager_authz, library denotes the library the callout can be found in, and symbol denotes the function name of the callout. And here's the cute part: the library argument can be specified in two forms, libfoo or libfoo_flavor. When you use the former version, the current flavor will automatically be added to the library name if needed. ✨ auto-magic, we love her.

🍓 Parameters

  • handle — The handle that is to be configured
  • filename — The file to read configuration from

🌈 Returns

This function returns GLOBUS_SUCCESS or a globus_result_t referring to an error object of one of the following types:

💀 Return values

  • GLOBUS_CALLOUT_ERROR_OPENING_CONF_FILE — Error opening filename
  • GLOBUS_CALLOUT_ERROR_PARSING_CONF_FILE — Error parsing file
  • GLOBUS_CALLOUT_ERROR_OUT_OF_MEMORY — Out of memory

🌟 globus_result_t globus_callout_register (globus_callout_handle_t handle, char * type, char * library, char * symbol) 🌟

Register callout configuration.

This function registers a callout type in the given handle. Short, sweet, does the thing. 💅

🍓 Parameters

  • handle — The handle that is to be configured
  • type — The abstract type of the callout
  • library — The location of the library containing the callout
  • symbol — The symbol (ie function name) for the callout

🌈 Returns

This function returns GLOBUS_SUCCESS or a globus_result_t referring to an error object of one of the following types:

💀 Return values

  • GLOBUS_CALLOUT_ERROR_OUT_OF_MEMORY — Out of memory

👑 Author 👑

Generated automatically by Doxygen for globus_callout from the source code. Not a human author, just a lil robot doing its thing. 🤖✨

💖 that's the whole page bestie, you ate. Now go register some callouts, main character energy only.

signing off from globus_callout, Version 4.3 of the globus_callout_config(3) manual page — iykyk 🌸🦋💜

📦 where this page comes from