AdvFS Command Line and Application Programming Interface External Reference Specification Version 1.13 JA CASL Not Inspected/Date Inspected Building ZK3 110 Spit Brook Road Nashua, NH 03062 Copyright (C) 2008 Hewlett-Packard Development Company, L.P. Page 1 of 65 Preface Version 1.4 of the AdvFS Command Line and API External Reference Specification is being made available to all partners in order to allow them to design and implement code meeting the specifications contained herein. 1 INTRODUCTION ....................................................................................................................................................................4 1.1 ABSTRACT .........................................................................................................................................................................4 1.2 AUDIENCE ..........................................................................................................................................................................4 1.3 TERMS AND DEFINITIONS ...................................................................................................................................................4 1.4 RELATED DOCUMENTS ......................................................................................................................................................4 1.5 ACKNOWLEDGEMENTS ......................................................................................................................................................4 2 PRODUCT FEATURES AND USAGE..................................................................................................................................5 2.1 OVERVIEW .........................................................................................................................................................................5 2.2 USE OF THE EXISTING COMMAND INTERFACE ...................................................................................................................5 2.3 JOURNALING FILE SYSTEM ................................................................................................................................................5 2.4 MULTIPLE DISK SUPPORT ..................................................................................................................................................5 2.5 FREEZING AND THAWING THE FILE SYSTEM ......................................................................................................................6 2.6 BACKUP UTILITIES .............................................................................................................................................................6 2.7 TRASHCANS .......................................................................................................................................................................6 2.8 ON-DISK STRUCTURE VIEWER ...........................................................................................................................................6 2.9 FILE SYSTEM EXPANSION ..................................................................................................................................................6 2.10 SNAPSHOT SUPPORT ..........................................................................................................................................................6 2.11 STORAGE THRESHOLDS .....................................................................................................................................................7 2.12 COMMAND SUMMARY .......................................................................................................................................................7 3 EXTERNAL REFERENCE SPECIFICATIONS..................................................................................................................9 3.1 INTERNAL INTERFACES ......................................................................................................................................................9 3.2 EXTERNAL INTERFACES .....................................................................................................................................................9 3.3 INTERFACE TO PROGRAMS .................................................................................................................................................9 3.3.1 Data Structures ............................................................................................................................................................9 3.3.2 advfs ioctl ...................................................................................................................................................................10 3.4 INTERFACE TO USERS ......................................................................................................................................................12 3.4.1 newfs_advfs ................................................................................................................................................................12 3.4.2 mkfs_advfs ..................................................................................................................................................................14 3.4.3 mount_advfs ...............................................................................................................................................................16 3.4.4 umount_advfs .............................................................................................................................................................19 3.4.5 quotacheck_advfs .......................................................................................................................................................20 3.4.6 extendfs_advfs ............................................................................................................................................................21 3.4.7 fsadm_advfs................................................................................................................................................................22 3.4.8 fsck_advfs ...................................................................................................................................................................34 3.4.9 ncheck_advfs ..............................................................................................................................................................37 3.4.10 quot_advfs..............................................................................................................................................................38 3.4.11 edquota, repquota, quotaon/quotaoff, quota .........................................................................................................39 3.4.12 ff_advfs ..................................................................................................................................................................40 3.4.13 advfreezefs/advthawfs............................................................................................................................................41 3.4.14 advstat ...................................................................................................................................................................44 3.4.15 advtrashcan ...........................................................................................................................................................45 3.4.16 advdump ................................................................................................................................................................46 3.4.17 advrestore..............................................................................................................................................................49 3.4.18 advdiskusg .............................................................................................................................................................53 3.4.19 advsalvage.............................................................................................................................................................54 3.4.20 advvods..................................................................................................................................................................57 3.4.21 advsavemeta ..........................................................................................................................................................61 4 PRODUCT ENVIRONMENT...............................................................................................................................................62 4.1 ASSUMPTIONS ..................................................................................................................................................................62 5 ISSUES ....................................................................................................................................................................................63 5.1 OPEN ISSUES ....................................................................................................................................................................63 5.1.1 fsadm (migrate) options..............................................................................................................................................63