X-Git-Url: https://git.whamcloud.com/?p=fs%2Flustre-release.git;a=blobdiff_plain;f=lustre%2Fdoc%2FMakefile.am;h=8fa2f1031f83e78a081c443cc118d2d76de2b991;hp=b8ee44775f380bdb3ff3ba6a947f7c833fc9d059;hb=956eeec06548f85c249b5a7495dc9bbdcb30b86b;hpb=92ae8b2d265c72c92269e03feb66c6dcae74f759 diff --git a/lustre/doc/Makefile.am b/lustre/doc/Makefile.am index b8ee447..8fa2f10 100644 --- a/lustre/doc/Makefile.am +++ b/lustre/doc/Makefile.am @@ -1,107 +1,191 @@ -# Copyright (C) 2001, 2002 Cluster File Systems, Inc. # -# This code is issued under the GNU General Public License. -# See the file COPYING in this distribution -LYX2PDF = tex2pdf -overwrite -LYX2PS = lyx --export ps -LYX2TEX = lyx --export latex -LYX2TXT = lyx --export text -LYX2HTML = lyx --export html -LATEX = latex -DVIPS = dvips -PS2PDF = ps2pdf -TEXEXPAND = texexpand -SUFFIXES = .lin .lyx .pdf .ps .sgml .html .txt .tex .fig .eps .dvi - -DOCS = lustre.pdf lustre-HOWTO.txt -IMAGES = sys_stat.eps sys_odirect.eps sys_open.eps sys_write.eps sys_mount.eps cache1.eps cache2.eps intermezzocache.eps intermezzofilesys.eps meta.eps metadata1.eps networklayer.eps bigpicture.eps intermezzo.eps mds.eps portals.eps client.eps layering.eps metadata.eps sb.eps cow.eps lockacq.eps obdfs.eps snapsetup.eps dirbodyapi.eps loraid.eps ost.eps updates.eps hotmigrate.eps lustreclusters.eps osthw.eps portals-lib.eps lockqueues.eps lockexample1.eps lockexample2.eps lockexample3.eps lockexample4.eps lockseverity.eps gssapi.eps lovextents.eps cpsd.eps setup-accept.eps authenticate.eps login.eps -LYXFILES= lustre.lin evolution.lyx llocks.lyx mgmt.lyx uncertain.lyx\ - fs.lyx lustre-HOWTO.lin namespace.lyx\ - glossary.lyx lustre-debugging.lyx network.lyx\ - intro.lyx obdspec.lyx recovery.lyx - -MAINTAINERCLEANFILES = $(IMAGES) $(DOCS) $(VERSIONED) -CLEANFILES = *.aux *.tex doc.old/*.aux doc.old/*.tex *.eps -VERSIONED = lustre-HOWTO.lyx lustre.lyx doc.old/lustre-HOWTO.lyx doc.old/lustre.lyx -GENERATED = $(VERSIONED) lustre-full.tex lustre-chbar.tex - -EXTRA_DIST = chbar.sh postbar $(DOCS) $(IMAGES) $(LYXFILES) lustre.bib - -all: $(DOCS) - -# These variables are set by lbuild/check-build. -RPMRELEASE ?= RELEASE -KERNTYPE ?= chaos -KERNRPM ?= kernel-2.4.18lustre13-RELEASE.i386.rpm - -# update date and version in document -date := $(shell date +%x) -tag := $(shell echo '$$Name: $$' | sed -e 's/^\$$Na''me: *\$$$$/HEAD/; s/^\$$Na''me: \(.*\) \$$$$/\1/') -addversion = sed -e 's|@T''AG@|$(tag)|g; s|@VER''SION@|$(VERSION)|g; s|@DA''TE@|$(date)|g; s|@RPM''RELEASE@|$(RPMRELEASE)|g; s|@KERN''TYPE@|$(KERNTYPE)|g; s|@KERN''RPM@|$(KERNRPM)|g' - -# Regenerate when the $(VERSION) or $Name: $ changes. -.INTERMEDIATE: $(GENERATED) -$(VERSIONED) : %.lyx: %.lin Makefile - $(addversion) $< > $@ - -.lyx.pdf: - @echo $(LYX2PDF) $< && $(LYX2PDF) $< || printf "\n*** Warning: not creating PDF docs; install lyx to rectify this\n" - -.lyx.ps: - @echo $(LYX2PS) $< && $(LYX2PS) $< || printf "\n*** Warning: not creating PostScript docs; install lyx to rectify this\n" - -.lyx.tex: - @echo $(LYX2TEX) $< && $(LYX2TEX) $< || printf "\n*** Warning: not creating LaTeX docs; install lyx to rectify this\n" - -.lyx.txt: - @echo $(LYX2TXT) $< && $(LYX2TXT) $< || printf "\n*** Warning: not creating text docs; install lyx to rectify this\n" - -.lyx.html: - @echo $(LYX2HTML) $< && $(LYX2HTML) $< || printf "\n*** Warning: not creating HTML docs; install lyx to rectify this\n" - -.tex.dvi: - $(LATEX) $< - $(LATEX) $< - -.dvi.ps: - $(DVIPS) $< -o $@ - -.ps.pdf: - $(PS2PDF) $< $@ - -lustre.tex lustre.pdf lustre.txt lustre.html: $(IMAGES) lustre-HOWTO.lyx -.fig.eps: - -fig2dev -L eps $< > $@ - -syncweb: lustre.pdf - cp lustre.pdf /usr/src/www/content/lustre/docs/lustre.pdf - ( cd /usr/src/www ; make lustre ; make synclustre ) -.PHONY: syncweb chbar - -# Build a changebar document from the files in doc.old and this directory. -chbar: lustre-chbar.pdf - -%-chbar.tex: chbar.sh postbar doc.old/%-full.tex %-full.tex - $(SHELL) $(srcdir)/chbar.sh doc.old/$*-full.tex $*-full.tex | $(srcdir)/postbar > $@ - -%-full.tex: %.tex - $(TEXEXPAND) -texinputs=. -texinputs=$(srcdir) -output=$@ $< - -doc.old/lustre.tex: doc.old/lustre-HOWTO.lyx -doc.old/%-full.tex: doc.old/%.tex - cd doc.old && $(TEXEXPAND) -texinputs=. -output=$*-full.tex $*.tex +# GPL HEADER START +# +# DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. +# +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License version 2 only, +# as published by the Free Software Foundation. +# +# This program is distributed in the hope that it will be useful, but +# WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +# General Public License version 2 for more details (a copy is included +# in the LICENSE file that accompanied this code). +# +# You should have received a copy of the GNU General Public License +# version 2 along with this program; If not, see +# http://www.gnu.org/licenses/gpl-2.0.html +# +# GPL HEADER END +# -# Check out the old directory if it doesn't exist. -doc.old/lustre.lin doc.old/lustre-HOWTO.lin: - @if test "X$(OLD)" = X; then \ - echo "You must populate doc.old or specify a CVS tag like OLD=v0_5_1"; \ - exit 1; \ - fi - rm -rf doc.old - mkdir doc.old - cvs checkout -r $(OLD) -d doc.old lustre/doc +# +# Copyright (c) 2001, 2010, Oracle and/or its affiliates. All rights reserved. +# Use is subject to license terms. +# +# Copyright (c) 2011, 2017, Intel Corporation. +# -dist-hook: - rm -rf $(distdir)/figs/CVS +# +# This file is part of Lustre, http://www.lustre.org/ +# Lustre is a trademark of Sun Microsystems, Inc. +# -include $(top_srcdir)/Rules +MANFILES = \ + lctl.8 \ + lctl-get_param.8 \ + lctl-list_param.8 \ + lctl-network.8 \ + lctl-set_param.8 \ + ldev.8 \ + ldev.conf.5 \ + lfs.1 \ + lfs-df.1 \ + lfs-fid2path.1 \ + lfs-find.1 \ + lfs-getstripe.1 \ + lfs-getdirstripe.1 \ + lfs-heat.1 \ + lfs-hsm.1 \ + lfs-ladvise.1 \ + lfs_migrate.1 \ + lfs-migrate.1 \ + lfs-mirror-create.1 \ + lfs-mirror-extend.1 \ + lfs-mirror-resync.1 \ + lfs-mirror-split.1 \ + lfs-mirror-verify.1 \ + lfs-mkdir.1 \ + lfs-path2fid.1 \ + lfs-pcc.1 \ + lfs-project.1 \ + lfs-setdirstripe.1 \ + lfs-setstripe.1 \ + lfs-setquota.1 \ + l_getidentity.8 \ + lgss_sk.8 \ + lhbadm.8 \ + llapi_create_volatile_param.3 \ + llapi_fd2parent.3 \ + llapi_file_create.3 \ + llapi_file_create_foreign.3 \ + llapi_file_get_stripe.3 \ + llapi_file_open.3 \ + llapi_group_lock.3 \ + llapi_group_unlock.3 \ + llapi_heat_get.3 \ + llapi_heat_set.3 \ + llapi_hsm_action_begin.3 \ + llapi_hsm_action_end.3 \ + llapi_hsm_action_get_dfid.3 \ + llapi_hsm_action_get_fd.3 \ + llapi_hsm_action_progress.3 \ + llapi_hsm_copytool_get_fd.3 \ + llapi_hsm_copytool_recv.3 \ + llapi_hsm_copytool_register.3 \ + llapi_hsm_copytool_unregister.3 \ + llapi_hsm_state_get.3 \ + llapi_hsm_state_set.3 \ + llapi_ladvise.3 \ + llapi_layout.7 \ + llapi_layout_alloc.3 \ + llapi_layout_comp_add.3 \ + llapi_layout_comp_del.3 \ + llapi_layout_comp_extent_get.3 \ + llapi_layout_comp_extent_set.3 \ + llapi_layout_comp_flags_clear.3 \ + llapi_layout_comp_flags_get.3 \ + llapi_layout_comp_flags_set.3 \ + llapi_layout_comp_id_get.3 \ + llapi_layout_comp_use.3 \ + llapi_layout_comp_use_id.3 \ + llapi_layout_file_comp_add.3 \ + llapi_layout_file_comp_del.3 \ + llapi_layout_file_create.3 \ + llapi_layout_file_open.3 \ + llapi_layout_free.3 \ + llapi_layout_get_by_fd.3 \ + llapi_layout_get_by_fid.3 \ + llapi_layout_get_by_path.3 \ + llapi_layout_get_by_xattr.3 \ + llapi_layout_ost_index_get.3 \ + llapi_layout_ost_index_set.3 \ + llapi_layout_pattern_get.3 \ + llapi_layout_pattern_set.3 \ + llapi_layout_pool_name_get.3 \ + llapi_layout_pool_name_set.3 \ + llapi_layout_stripe_count_get.3 \ + llapi_layout_stripe_count_set.3 \ + llapi_layout_stripe_size_get.3 \ + llapi_layout_stripe_size_set.3 \ + llapi_path2fid.3 \ + llapi_path2parent.3 \ + llapi_quotactl.3 \ + ll_decode_linkea.8 \ + llobdstat.8 \ + llog_reader.8 \ + llsom_sync.8 \ + llstat.8 \ + lnetctl.8 \ + lst.8 \ + lustre.7 \ + lustreapi.7 \ + lustre_routes_config.8 \ + lustre_routes_conversion.8 \ + lustre_rsync.8 \ + mount.lustre.8 \ + mount.lustre_tgt.8 \ + nids.5 \ + plot-llstat.8 \ + routerstat.8 + +SERVER_MANFILES = \ + lctl-barrier.8 \ + lctl-lcfg.8 \ + lctl-lfsck-query.8 \ + lctl-lfsck-start.8 \ + lctl-lfsck-stop.8 \ + lctl-llog_cancel.8 \ + lctl-llog_catlist.8 \ + lctl-llog_info.8 \ + lctl-llog_print.8 \ + lctl-nodemap-activate.8 \ + lctl-nodemap-add.8 \ + lctl-nodemap-add-idmap.8 \ + lctl-nodemap-add-range.8 \ + lctl-nodemap-del.8 \ + lctl-nodemap-del-idmap.8 \ + lctl-nodemap-del-range.8 \ + lctl-nodemap-modify.8 \ + lctl-nodemap-set-fileset.8 \ + lctl-nodemap-set-sepol.8 \ + lctl-snapshot-create.8 \ + lctl-snapshot-destroy.8 \ + lctl-snapshot-list.8 \ + lctl-snapshot-modify.8 \ + lctl-snapshot-mount.8 \ + lctl-snapshot-umount.8 \ + ll_decode_filter_fid.8 \ + llverdev.8 \ + lshowmount.8 \ + mkfs.lustre.8 \ + tunefs.lustre.8 + +if SERVER +MANFILES += $(SERVER_MANFILES) +else +DISTONLY_MANFILES = $(SERVER_MANFILES) +endif + +if UTILS +if MANPAGES +man_MANS = $(MANFILES) +endif +endif + +CLEANFILES = *.aux *.tex *.log *.pdf + +EXTRA_DIST = $(MANFILES) $(DISTONLY_MANFILES) + +all: