NEWGFS(8,C)                 AIX Commands Reference                  NEWGFS(8,C)



-------------------------------------------------------------------------------
newgfs



PURPOSE

Finds an available GFS number and reserves its place and number in /etc/fsmap.

SYNTAX


          +------+   +------------+   +----------+   +---------+
newgfs ---|      |---|     one of |---|          |---|         |--->
          +- -v -+   |      +---+ |   +- -d dev -+   +- -f fs -+
                     +- -r -| p |-+
                            | r |
                            | n |
                            +---+

    +-----------+
>---|           |--- mountpoint ---|
    +- -s site -+


Warning: See restrictions, Chapter 18, AIX Programming Tools and Interfaces.

DESCRIPTION

The newgfs command provides a unique free Global File System (GFS) number for a
file system to be mounted on mountpoint and reserves a dummy stanza for that
GFS in /etc/fsmap file.  The dummy stanza should be cleaned out of the
/etc/fsmap file and replaced by the real stanza out of the /local/filesystems
file by running syncfsmap.  Unless a file with the dummy file system stanza for
mountpoint is supplied by specifying -f flag, newgfs assumes that the file
system info exists in /local/filesystems (or another site's file systems file
if -s flag is supplied).  In general, command line flags over-ride the
information provided in the dummy stanza.

FLAGS

The options are (in order of evaluation):

-v       verbose mode.  Allows newgfs to report inconsistencies and errors in
         /etc/fsmap.

-s site  site on which this file system will be residing.  If this flag is
         present, LOCAL is set to that site's /local and device and
         /local/filesystems references are assumed to be for that site (this
         implies that if the site does not yet exist, it nevertheless has to be
         in /etc/site and either -f and/or -r flags must be used to provide
         info about the file system).



Processed November 8, 1990        NEWGFS(8,C)                                 1

NEWGFS(8,C)                 AIX Commands Reference                  NEWGFS(8,C)




-f fs    file where a dummy stanza of a file system can be found.  The
         following is the necessary information:

         /xyz:

         dev = /dev/hd3
         vol = "/xyz"
         site
             = electra
         ftype
             = repl, primary

         The file fs provides default parameters some of which can be overriden
         from the command line.  The -r option overrides ftype; -d overrides
         dev; and -s overrides sites.

         Special care must be taken with the format of the stanza.  Mount point
         must start in column 0 and be terminated by a colon.  vol should be
         the same string as the mount point string.  Acceptable ftype (file
         system type, for example, replication) values are repl, nonrepl and
         repl,primary.  If ftype is primary, the above format (quotes and
         spacing) MUST be adhered to!  Invalid ftype will be defaulted to
         nonrepl.

         Site specification site will not over-write -s flag's specification.

         Ideally, the dummy stanza file should be generated by a program (like
         minidisks or newsite) rather than by a user.

r opt    Define the file system's replication.  Available mutually exclusive
         options are:

         p   primary, implies replication
         r   replicated, implies back-bone
         n   non-replicated

-d dev   Device where the file system is located (this is useful for
         re-assigning GFS# when a site is being moved into another cluster and
         the file system already exists); device name should be a complete
         local path (for example, /dev/diskxzy).

         This flag will override the info provided in the dummy stanza.

         If replication has not yet been set (-r flag was not passed) the
         replication will be looked up in the superblock.

The newgfs command will print the reserved GFS# to the standard output.  If the
file system is replicated and another copy of the file system already exists,
its GFS# is returned (gfspack is not set).  Special care is taken to lock
/etc/fsmap file while newgfs is processing it.  A dummy stanza reserving the
GFS#, the site and the mount point is added to the /etc/fsmap.



Processed November 8, 1990        NEWGFS(8,C)                                 2

NEWGFS(8,C)                 AIX Commands Reference                  NEWGFS(8,C)




If successful, newgfs exits with status 0.  On failure, newgfs prints out a
diagnostic message to standard error and exits with status -1.

DIAGNOSTICS

Invoked without any parameters, newgfs will produce a usage message.

Most of diagnostic messages are self-explanatory.  Complaints about file system
already existing stem from already having a replicated or or non-replicated
file system with the same mount-point for the same site, or having a
non-replicated file system with the same mount-point on another site in the
/etc/fsmap.

RELATED INFORMATION

See the following commands:  "syncfsmap,"  "mount,"  "fsck, dfsck," and
"minidisks." See in the Technical Reference Vol II, "file systems" and
"format".




































Processed November 8, 1990        NEWGFS(8,C)                                 3