fs_newalias - Creates a new alias for a cell [UNIX only]


fs newalias [-alias] <alias name> [-name] <cell name> [-help]


The fs newalias command can be used when the Cache Manager is in Dynamic Root (-dynroot) mode. It creates a symbolic link in /afs from an alias to the full name of the cell. It also creates a symbolic link from the alias prepended with . to the full name of the cell prepended with ., the convention for access to the read/write path of that cell.

This command is used to supplement aliases imported from the configuration /etc/yfs/yfs-client.conf file when afsd starts.

Historically, aliases would be created by the cell administrator by adding symbolic links to the root.afs volume. Such symlinks do not appear when Dynamic Root is enabled because, with Dynamic Root, the Cache Manager does not mount or look at the root.afs volume. This alias capability is a replacement that allows such short names to be created under client control.


Aliases created with fs newalias are temporary and will be forgotten when the Cache Manager is restarted or the client machine is rebooted. In order to make the alias permanent, it must be put into the /etc/yfs/yfs-client.conf file.

There is no way to remove an alias once created without restarting the Cache Manager.

Aliases provide a convenient short-hand for end users to access a cell but they are not guaranteed to be accessible from all devices. Whenever paths are stored in files or otherwise shared with other systems the full cell name should be used instead of the alias.


-alias <alias name>

This is the short name to which the user wants to map the real cell name.

-name <cell name>

This is the real cell name.


Prints the online help for this command. All other valid options are ignored.


This command produces no output other than error messages.


There are two ways to call fs newalias:

   % fs newalias ycn
   % fs newalias -alias fcn -name

The above examples create aliases ycn for the cell and fcn for the cell Four links will be created in /afs:

   /afs/.fcn  ->  /afs/
   /afs/.ycn  ->  /afs/
   /afs/fcn   ->  /afs/
   /afs/ycn   ->  /afs/


The issuer must be logged in as the local superuser root.


afsd(8), fs_listaliases(1), yfs-client.conf(5)


Copyright 2007 Jason Edgecombe <>

This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Jason Edgecombe for OpenAFS.


"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)

"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)

The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).

"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).

"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.