Return to fmadm.8 CVS log

Up to [Coherent Logic Development] / freem / doc

Annotation of freem/doc/fmadm.8, revision 1.1

1.1     ! snw         1: .\" To display this man page, either:
        !             2: .\"   1) Install this file along with the other subject.8 files in your
        !             3: .\"      system's man1 directory (usually this is /usr/man/man18) and
        !             4: .\"      enter the command:
        !             5: .\"        man fmadm
        !             6: .\"   or
        !             7: .\"   2) Specify the input (this file) and the output (your favorite pager)
        !             8: .\"      explicitly.  For example, if this file is in your current working
        !             9: .\"      directory, you can use the following to view the formatted man page
        !            10: .\"      using the "less" pager:
        !            11: .\"        man ./fmadm.8 | less
        !            12: .\"
        !            13: .\" To print this man page to a PostScript printer:
        !            14: .\"   man -t ./fmadm.8 | lpr
        !            15: .\"
        !            16: .\"   $Id$
        !            17: .\"    fmadm man page
        !            18: .\"
        !            19: .\"  
        !            20: .\"   Author: Serena Willis <snw@coherent-logic.com>
        !            21: .\"    Copyright (C) 2025 Coherent Logic Development LLC
        !            22: .\"
        !            23: .\"
        !            24: .\"   This file is part of FreeM.
        !            25: .\"
        !            26: .\"   FreeM is free software: you can redistribute it and/or modify
        !            27: .\"   it under the terms of the GNU Affero Public License as published by
        !            28: .\"   the Free Software Foundation, either version 3 of the License, or
        !            29: .\"   (at your option) any later version.
        !            30: .\"
        !            31: .\"   FreeM is distributed in the hope that it will be useful,
        !            32: .\"   but WITHOUT ANY WARRANTY; without even the implied warranty of
        !            33: .\"   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        !            34: .\"   GNU Affero Public License for more details.
        !            35: .\"
        !            36: .\"   You should have received a copy of the GNU Affero Public License
        !            37: .\"   along with FreeM.  If not, see <https://www.gnu.org/licenses/>.
        !            38: .\"
        !            39: .\"   $Log$
        !            40: .\"
        !            41: .TH fmadm 8 "3 April 2025" FreeM "FreeM User Manual"
        !            42: .SH NAME
        !            43: fmadm
        !            44: .SH SYNOPSIS
        !            45: fmadm <action> <object> [-e=<environment] [-n=<namespace>] [-u=<user>] [-g=<group>] [-E=true|false] [OPTIONS]
        !            46: 
        !            47: fmadm configure [-e=<environment] [-n=<namespace>] [-u=<user>] [-g=<group>] [-E=true|false]
        !            48: 
        !            49: fmadm reconfigure [-e=<environment] [-n=<namespace>] [-u=<user>] [-g=<group>] [-E=true|false]
        !            50: 
        !            51: <action> can be one of:
        !            52:     list, examine, verify, remove, import, export, backup, restore,
        !            53:     edit, start, stop, restart, status
        !            54: 
        !            55: <object> can be one of:
        !            56:     lock, journal, namespace, global, routine, job,
        !            57:     environment
        !            58: 
        !            59: Running fmadm with no command-line arguments will start the interactive mode.
        !            60: .SH DESCRIPTION
        !            61: The
        !            62: .B fmadm
        !            63: program is a systems administration tool used by FreeM operators to manage their environments.
        !            64: 
        !            65: Please see the FreeM texinfo documentation for more details ("info freem").
        !            66: .SH FLAGS
        !            67: Please note that fmadm flags MUST consist of a hyphen, the letter representing the flag, an equal sign, and the value for the flag.
        !            68: 
        !            69: A valid flag looks like this:
        !            70: 
        !            71: \-e=DEFAULT
        !            72: 
        !            73: Spaces surrounding the equal sign, or a space in lieu of the equal sign, are
        !            74: invalid syntax.
        !            75: 
        !            76: .TP
        !            77: \-e
        !            78: Sets the environment to be acted upon in this fmadm session. 'DEFAULT' is assumed if this flag is not provided.
        !            79: .TP
        !            80: \-n
        !            81: Sets the namespace to be acted upon in this fmadm session. 'SYSTEM' is assumed if this flag is not provided.
        !            82: .TP
        !            83: \-u
        !            84: Sets the owning UNIX account of the environment. 'freem' is assumed if this flag is not provided. The UNIX account must already exist on your system.  Applies only to 'fmadm configure' and 'fmadm reconfigure'. 
        !            85: .TP
        !            86: \-g
        !            87: Sets the owning UNIX group of the environment. 'freem' is assumed if this flag is not provided. The UNIX group must already exist on your system. Applies only to 'fmadm configure' and 'fmadm reconfigure'.
        !            88: .TP
        !            89: \-E
        !            90: Enables or disables an environment. Valid values are 'true' and 'false'. 'true' is assumed if this flag is not provided. Applies only to 'fmadm configure' and 'fmadm reconfigure'.
        !            91: .SH ACTIONS
        !            92: .TP
        !            93: configure
        !            94: Configures an environment. No object will be used with this action. Instead, the -e, -u, -g, and -E flags will be referenced.
        !            95: .TP
        !            96: reconfigure
        !            97: Reconfigures an environment. No object will be used with this action. Instead, the -e, -u, -g, and -E flags will be referenced.
        !            98: .TP
        !            99: list
        !           100: Generates a list of <object>s. Applies to lock, routine, global, and job.
        !           101: .TP
        !           102: examine
        !           103: Examines a specific instance of <object>. Applies to routine, global, job, and journal.
        !           104: .TP
        !           105: verify
        !           106: Verifies the integrity of <object>. Applies to global.
        !           107: .TP
        !           108: remove
        !           109: Removes an instance of <object>. Applies to job, lock, routine, and global.
        !           110: .TP
        !           111: import
        !           112: Imports an instance of <object>. Applies to routine (imports routine archives in RO/RSA format).
        !           113: .TP
        !           114: export
        !           115: Exports an instance of <object>. Applies to routine (exports routine archives in RO/RSA format).
        !           116: .TP
        !           117: backup
        !           118: Backs up an instance of <object>. Applies to routine.
        !           119: .TP
        !           120: restore
        !           121: Restores an instance of <object>. Applies to journal (plays back after-image journals).
        !           122: .TP
        !           123: edit
        !           124: Edits an <object>. Applies to routine (will open the routine in $EDITOR) and global (will open the interactive global editor).
        !           125: .TP
        !           126: start
        !           127: Starts one environment, multiple environments, or all environments. Applies to environment.
        !           128: .TP
        !           129: stop
        !           130: Stops one environment, multiple environments, or all environments. Applies to environmen
        !           131: .TP
        !           132: restart
        !           133: Restarts one environment, multiple environments, or all environments. Applies to environment.
        !           134: .TP
        !           135: status
        !           136: Gets the status of one environment, multiple environments, or all environments. Applies to environment.
        !           137: .SH "FURTHER INFORMATION"
        !           138: Please note that the primary documentation for FreeM is the 'info' manual, accessed with the following command:
        !           139: 
        !           140: info freem
        !           141: 
        !           142: These manual pages are minimal, and maintained on a strictly best-effort basis.
        !           143: .SH "RETURN VALUES"
        !           144: Returns 0 for non-error condition.
        !           145: .SH FILES
        !           146: .TP
        !           147: env.conf
        !           148: The FreeM environment catalog. Normally located in $PREFIX/etc/freem/env.conf
        !           149: .TP
        !           150: freem.conf
        !           151: The FreeM configuration file. Normally located in $PREFIX/etc/freem/<environment-name>/freem.conf.
        !           152: .SH ENVIRONMENT
        !           153: .TP
        !           154: \$EDITOR
        !           155: Determines the text editor used by `edit routine`.
        !           156: .SH BUGS
        !           157: Check the issue tracker at https://bugs.coherent-logic.com for more detailed information on current bugs.
        !           158: .SH AUTHOR
        !           159: Authored, maintained and updated by Serena Willis (snw@coherent-logic.com)
        !           160: .SH COPYRIGHT
        !           161: Copyright (C) 2014, 2021, 2025 Coherent Logic Development LLC
        !           162: 
        !           163: Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, with no Front-Cover texts, and with no Back-Cover Texts.
        !           164: 
        !           165: .SH "SEE ALSO"
        !           166: .BR freem (1)