NAME

delsysadm − sysadm interface menu or task removal tool

SYNOPSIS

delsysadm task | [−r] menu

DESCRIPTION

The delsysadm command deletes a task or menu from the sysadm interface and modifies the interface directory structure on the target machine. 

task | menu
The logical name and location of the menu or task within the interface menu hierarchy. Begin with the top menu main and proceed to where the menu or the task resides, separating each name with colons.  See EXAMPLES. 

If the -r option is used, this command will recursively remove all sub-menus and tasks for this menu.  If the -r option is not used, the menu must be empty. 

delsysadm should only be used to remove items added as "on-line" changes with the edsysadm command.  Such an addition will have a package instance tag of ONLINE.  If the task or menu (and its sub-menus and tasks) have any package instance tags other than ONLINE, you are asked whether to continue with the removal or to exit.  Under these circumstances, you probably do not want to continue and you should rely on the package involved to take the necessary actions to delete this type of entry. 

The command exits successfully or provides the error code within an error message. 

EXAMPLES

To remove the nformat task, execute:

delsysadm main:applications:ndevices:nformat. 

DIAGNOSTICS

0   Successful execution
2   Invalid syntax
3   Menu or task does not exist
4   Menu not empty
5   Unable to update interface menu structure

NOTES

Any menu that was originally a placeholder menu (one that only appears if submenus exist under it) will be returned to placeholder status when a deletion leaves it empty. 

When the −r option is used, delsysadm checks for dependencies before removing any subentries.  (A dependency exists if the menu being removed contains an entry placed there by an application package).  If a dependency is found, the user is shown a list of packages that depend on the menu being deleted and asked whether or not to continue.  If the answer is yes, the menu and all of its menus and tasks are removed (even those shown to have dependencies).  If the answer is no, the menu is not deleted. 

delsysadm should only be used to remove menu or task entries that have been added to the interface with edsysadm. 

SEE ALSO

edsysadm(1M), sysadm(1M)

  —  Essential Utilities