Bug 162775 - zpool(1): Document some undocumented zpool import options
Summary: zpool(1): Document some undocumented zpool import options
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: freebsd-fs (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2011-11-22 23:50 UTC by Enji Cooper
Modified: 2018-04-10 18:54 UTC (History)
1 user (show)

See Also:


Attachments
zpool.txt (9.29 KB, text/plain; charset=US-ASCII)
2012-06-17 19:40 UTC, araujobsdport
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description Enji Cooper freebsd_committer freebsd_triage 2011-11-22 23:50:01 UTC
There are a few options that aren't documented in the import section of the zpool manpage (at least not in the one that we have with the additional updates, and potentially not in the OpenSolaris manpage either). They are [according to the out of date comment above cddl/contrib/opensolaris/cmd/zpool/zpool_do_import()]:

                case 'F':
                        do_rewind = B_TRUE;
                        break;

                case 'm':
                        flags |= ZFS_IMPORT_MISSING_LOG;
                        break;

                case 'N':
                        flags |= ZFS_IMPORT_ONLY;
                        break;

                case 'T':
                        errno = 0;
                        txg = strtoull(optarg, &endptr, 10);
                        if (errno != 0 || *endptr != '\0') {
                                (void) fprintf(stderr,
                                    gettext("invalid txg value\n"));
                                usage(B_FALSE);
                        }
                        rewind_policy = ZPOOL_DO_REWIND | ZPOOL_EXTREME_REWIND;
                        break;

                case 'V':
                        flags |= ZFS_IMPORT_VERBATIM;
                        break;

                case 'X':
                        xtreme_rewind = B_TRUE;
                        break;
Comment 1 Benedict Reuschling freebsd_committer freebsd_triage 2012-06-04 20:46:25 UTC
Responsible Changed
From-To: freebsd-doc->mm

This should be checked by someone more familiar with ZFS code. 

I've compared the zpool(8) synopsis with the case labels from the PR 
description and I've found that the last three options (T, V, X) are 
not there. 

@mm: Can you take a look at this? Thanks!
Comment 2 Marcelo Araujo freebsd_committer freebsd_triage 2012-06-15 12:42:58 UTC
Responsible Changed
From-To: mm->araujo

Let me take care of it, I'm working to document zpool features, and for 
those 3, I have a patch that I'll provide this weekend.
Comment 3 Marcelo Araujo freebsd_committer freebsd_triage 2012-06-17 19:56:38 UTC
Responsible Changed
From-To: araujo->mm

Martin has the power to move forward with this PR.
Comment 4 Enji Cooper freebsd_committer freebsd_triage 2015-10-24 23:38:28 UTC
-T, -V, -X aren't documented in zpool(8); everything else seems to be accounted for now. Reassigning to freebsd-fs@