gensio_add_default(3)

💖 gensio_add_default 💖

okay bestie, welcome to the Library Functions Manual, section 3 — yes we're in the C library zone, get comfy, grab a boba 🧋, because this page is literally all about defaults and honestly? it eats.

🌸 NAME 🌸

gensio_add_default, gensio_set_default, gensio_get_default, gensio_get_defaultaddr, gensio_del_default, gensio_reset_defaults — Handle default values for gensios ✨

🎀 SYNOPSIS 🎀

#include <gensio/gensio.h>
struct gensio_enum_val {
    char *name;
    int val;
};

int gensio_add_default(struct gensio_os_funcs *o,
                    const char *name,
                    enum gensio_default_type type,
                    const char *strval, int intval,
                    int minval, int maxval,
                    const struct gensio_enum_val *enums);

int gensio_set_default(struct gensio_os_funcs *o,
                    const char *class, const char *name,
                    const char *strval, int intval);

int gensio_get_default(struct gensio_os_funcs *o,
                    const char *class, const char *name,
                    bool classonly,
                    enum gensio_default_type type,
                    char **strval, int *intval);

int gensio_get_defaultaddr(struct gensio_os_funcs *o,
                    const char *class, const char *name,
                    bool classonly,
                    int iprotocol, bool listen,
                    bool require_port,
                    struct addrinfo **rai);

int gensio_del_default(struct gensio_os_funcs *o,
                    const char *class, const char *name,
                    bool delclasses);

int gensio_reset_defaults(struct gensio_os_funcs *o);

no cap, that's the whole squad of functions right there 👑

🦋 DESCRIPTION 🦋

Defaults are the vibe where you set overall defaults or class-based defaults for gensio options — and yes, you can also use this whole thing yourself to create your very own defaults, main character energy fr. The various options for gensios are described over in gensio(5) if you wanna go read the lore.

For default values, each class will use gensio_get_default with their class (serialdev, telnet, ssl, etc.) with the name as the given option name. So here's the tea ☕: if a value has been set for its class, it will use that value. If a value has been set with class set to NULL (a "global" default) then the value will be used from there. Otherwise the code will use it's own internal default value. periodt.

Any option provided in the gensio string will override any default value, of course. obviously 💅

The classonly parameter means to not look in the global defaults. If you use this for your own defaults, it is recommended that you use your own class and set classonly to true. do that, bestie, trust 🙏

Defaults come in one of four formats defined by type: GENSIO_DEFAULT_INT, GENSIO_DEFAULT_BOOL, GENSIO_DEFAULT_ENUM, GENSIO_DEFAULT_STR, GENSIO_DEFAULT_DATA. (the page says four and then lists five, and honestly we are simply not going to question the source material 💀)

int and bool are pretty self-explanatory. Except that if you pass in a non-NULL strval when setting one, the code will attempt to get the value from the strval and will return NULL if the value is not valid. It will attempt to translate "true" and "false" for bool values. And if the value is <minval or >maxval, GE_OUTOFRANGE is returned from any set operation. so like, stay in your range 🫶

When setting a str, the value is copied, you don't have to keep the copy around for yourself. so you can just let it go, it's fine 🌈

When getting a string value, the value is duplicated with gensio_strdup, you should free it with o->free(). do not forget this one — that's a memory leak, and a memory leak is not the vibe 😭

Data is like strings, except the length is passed in intval and it is returned the same way. This will hold arbitrary raw data. Like strings, when you get a data value you should free it with o->free(). same rule, same energy 💜

If it's a enum, setting the value you will pass in a string and a table of possible values in enum (terminated with a NULL name). The code will look up the string you pass in in the enums table, and set the value to the integer value. If the string is not in the enums table, it will return GE_INVAL. When you get the value, it will return the value in intval. cute and efficient, obsessed ✨

When getting the value, the type must match what is set in the set call. If the name is not found, GE_NOTFOUND is returned. If the type does not match, then GE_INVAL is returned. Note that if you save a value as an enum, you can fetch it as an int. slay, flexible 💅

Setting the same default again will replace the old value. out with the old, in with the new 🎀

gensio_del_default deletes the given default. You can only delete user-added defaults, not ones created by the gensio library — that's not yours to touch, bestie. If there are any class-specific default registered against the default, this call will fail with GE_INUSE unless delclasses is true, which will cause all the class defaults to be deleted, too. so like, know what you're doing before you flip that switch 👀

gensio_reset_defaults will reset all defaults to the value set when gensio_add_default was called to create the default, or the built-in default value. factory reset but make it fancy 🌟

gesnio_get_defaultaddr gets an address from the given default string. See gensi_scan_network_port in gensio/gensio.h for details on how the string is formatted, what the parameters mean, and how to handle the addrinfo struct. (those two names are spelled exactly like the page spells them — we reproduce, we do not editorialize 🙈)

⭐ RETURN VALUES ⭐

Zero is returned on success, or a gensio error on failure. that's it, that's the whole story 🔥

🌈 SEE ALSO 🌈

• gensio_err(3)
• gensio(5)

and that's the page, bestie 💖 it came from the Library Functions Manual and it was last touched 27 Feb 2019 — shoutout to gensio_add_default(3) for keeping the defaults in check all this time, iconic behavior, no notes 👑✨