IINIT(1)

🎀 NAME 🎀

okay so this is the iinit(1) page from the User Commands section, and it's about iinit — an iRODS iCommand. main character energy, fr fr 💅

✨ SYNOPSIS ✨

iinit [-hvVl] [--ttl TTL] [--with-ssl] [--prompt-auth-scheme]

🌸 DESCRIPTION 🌸

So iinit creates a file containing your iRODS password in a scrambled form, and that file is used automatically by the icommands. iconic behavior, honestly 🫶

iinit loads environment information from the following locations, with priority being given to the top of the list:

1. in specific environment variables
2. in an irods_environment.json file located at IRODS_ENVIRONMENT_FILE
3. in ~/.irods/irods_environment.json
4. default values set in the server

The active client environment file will be updated each time iinit is run in order to ensure that the settings are applied properly when connecting to the server. no cap, it keeps things in sync ✨

If any setting from the minimal client environment is found to be missing, prompts will be presented to the user to retrieve the missing required configurations. The 4 required configuration values are:

• irods_host
• irods_port
• irods_user_name
• irods_zone_name

Finally, iinit will prompt the user for a password for some plugins. For an automated environment, the password can be piped to stdin like so:

$ echo $MY_IRODS_PASSWORD | iinit

Of course, if there are missing client environment configuration values, these will need to be addressed in the piped input first. lowkey important, bestie 🙈

When using regular iRODS passwords you can use --ttl (Time To Live) to request a credential (a temporary password) that will be valid for only the number of hours you specify (up to a limit set by the administrator). This is more secure, as this temporary password (not your permanent one) will be stored in the obfuscated credential file (.irodsA) for use by the other iCommands. security slay 🔥

When using PAM, iinit always generates a temporary iRODS password for use by the other iCommands, using a time-limit set by the administrator (usually a few days). With the --ttl option, you can specify how long this derived password will be valid, within the limits set by the administrator. periodt 💜

💅 OPTIONS 💅

• -l — list the iRODS environment variables (only)
• -v — verbose
• -V — Very verbose
• --ttl TTL — set the password Time To Live (specified in hours)
• --with-ssl — Include prompts which will set up TLS communications in the client environment.
• --prompt-auth-scheme — Include a prompt to select the authentication scheme. If not specified and no active client environment file exists, the default is 'native'.
• -h — this help

---

that's the whole page, bestie — brought to you by iRODS Version 5.0.2, iinit, iRODS-5.0.2, dated January 1980. periodt 💅✨